JSON을 쿼리 스트링으로 변환

사용 방법

1. 1

   JSON 객체 붙여넣기

   파라미터를 JSON으로 붙여넣거나 샘플(API 응답, 중첩 배열, 경계 사례)을 불러옵니다. 쿼리 스트링에는 이름이 필요하므로 최상위 배열이나 단순 값은 거부됩니다.

2. 2

   배열 방식 고르기

   서버나 프레임워크가 기대하는 대로 인덱스 배열 a[0]=1, 대괄호 배열 a[]=1, 반복 키 a=1&a=2 중 하나를 고릅니다.

3. 3

   null과 빈 값 정하기

   null은 a=로 쓰거나, 빼거나, 텍스트 a=null로 쓸 수 있습니다. 빈 배열과 빈 객체는 기본적으로 빠지고, 배열은 a[]=, 객체는 a=로 남길 수도 있습니다.

4. 4

   대괄호 인코딩 선택

   대괄호는 기본으로 %5B, %5D로 인코딩됩니다. [ ] 이스케이프 안 함을 켜면 브라우저나 로그에 붙여넣어 읽기 쉬운 형태로 둡니다.

5. 5

   알림 확인 후 사용

   알림은 뺀 빈 값·null의 수를, 파라미터 수치는 쓴 개수를 알려 줍니다. 출력을 ? 뒤에 붙이거나 폼 본문으로 보내고, 쿼리→JSON 도구로 다시 풀어 왕복이 맞는지 확인하세요.

작동 원리

실제 예시

{"q":"hello world","page":2,"ok":true}

q=hello+world&page=2&ok=true

{"tags":["a","b"],"filter":{"min":1,"max":null}}

tags%5B0%5D=a&tags%5B1%5D=b&filter%5Bmin%5D=1&filter%5Bmax%5D=

{"tags":["a","b"],"page":2}

tags=a&tags=b&page=2

{"a":null,"tags":[],"o":{},"d":{"x":1}}

a=null&tags[]=&o=&d[x]=1

{"x":"a&b=c","k":"한글","a b":1}

x=a%26b%3Dc&k=%ED%95%9C%EA%B8%80&a+b=1

{"a":[{"b":1},{"b":2}]}

a%5B%5D%5Bb%5D=1&a%5B%5D%5Bb%5D=2

자주 하는 실수

• 빈 배열과 객체는 기본으로 사라집니다

  {"tags":[]}는 알림과 함께 빈 쿼리 스트링이 되어 서버가 빈 목록과 없는 값을 구분하지 못합니다. 차이가 중요하면 빈 배열과 객체 옵션을 a[]=로 남김으로 바꾸세요.

• 서버가 이해하는 null 방식을 고르세요

  a=는 대부분의 서버에 빈 문자열로, a=null은 네 글자 텍스트로 전달되고, 키를 빼면 아예 보내지 않은 것과 같습니다. 쿼리 스트링에는 진짜 null이 없으므로 어느 쪽도 null이 아닙니다.

• 숫자가 타입을 잃습니다

  모든 값이 텍스트가 됩니다. page=2는 문자열 2로 서버에 닿고 불리언은 true, false 문자열로 도착합니다.

• 대괄호와 반복 방식은 객체 경계를 흐립니다

  {"a":[{"b":1,"c":2}]}처럼 키가 여러 개인 객체의 배열은 대괄호 방식에서 a[][b]=1&a[][c]=2가 되고, 파서는 이를 객체 두 개로 읽습니다. 객체 배열에는 인덱스 방식을 쓰세요. 반복 키 방식은 중첩 배열을 평평하게 만들고 원소가 하나인 배열을 단순 값으로 바꾼다는 점도 기억하세요.

• 루트는 객체여야 합니다

  최상위 배열이나 단순 값은 거부됩니다. 원하는 키를 가진 객체로 감싸세요.

• 너무 긴 쿼리 스트링은 거부될 수 있습니다

  브라우저, 프록시, 서버는 보통 URL을 수천~8천 자로 제한합니다. 큰 데이터는 POST 본문을 쓰세요.

자주 묻는 질문