긴 URL은 그대로는 리뷰하기 어렵습니다

캠페인 URL이나 API의 GET 요청에서는 ?utm_source=...&utm_medium=...&id=...처럼 많은 파라미터가 나열됩니다. 짧은 URL이라면 눈으로 볼 수 있지만, 값이 늘어날수록 키 중복, 철자 오류, 불필요한 트래킹 값을 놓치기 쉬워집니다.

URL 파라미터를 JSON으로 확인하는 방법: UTM과 API 쿼리의 누락 줄이기

DevToolKits의 **URL 파라미터 JSON 변환 도구**를 쓰면 URL이나 쿼리 문자열을 붙여넣기만 해도 키와 값을 JSON 형식으로 확인할 수 있습니다.

UTM 체크에서 보는 포인트

광고나 SNS 게시용 URL에서는 utm_source, utm_medium, utm_campaign의 값이 측정 결과에 그대로 영향을 줍니다. 대소문자나 표기 흔들림이 있으면 분석 도구에서 다른 캠페인으로 집계될 수 있습니다.

공개 전에는 JSON화한 파라미터를 보며 의도한 명명 규칙에 맞는지 확인하면 안전합니다.

API 디버깅에도 쓸 수 있습니다

API의 GET 요청에서는 검색 조건, 페이지 번호, 정렬 조건 등이 쿼리 파라미터에 들어갑니다. JSON으로 정리하면 명세서나 이슈에 붙이기 쉽고, 팀에서 같은 조건을 재현하기 쉬워집니다.

예를 들어 다음과 같은 URL을 리뷰할 때입니다.

https://example.com/search?q=jwt&page=2&sort=updated&tag=security&tag=api

JSON화하면 page가 문자열로 전달되는지, tag가 여러 번 지정되는지, 빈 값이 섞여 있지는 않은지 확인하기 쉬워집니다. API 측이 tag=security,api를 기대하는데 프론트가 tag=security&tag=api로 보내는 어긋남도 일찍 발견할 수 있습니다.

값이 URL 인코딩되어 있다면 **URL 인코드·디코드 도구**로 문자열의 의미도 확인할 수 있습니다.

이슈에 남길 때의 작성법

버그 리포트에서는 URL 전문만 붙이기보다, 분해한 JSON과 기대값을 함께 남기면 재현이 빨라집니다.

{
  "q": "jwt",
  "page": "2",
  "sort": "updated",
  "tag": ["security", "api"]
}

이 형태라면 ‘검색어’ ‘페이징’ ‘정렬 순서’ ‘필터 조건’을 따로따로 확인할 수 있습니다. 긴 URL을 읽는 부담이 줄고, 리뷰하는 사람도 차이에만 집중할 수 있습니다.

인코딩과 배열 표현의 함정

URL 파라미터를 리뷰할 때 놓치기 쉬운 것이 인코딩과 배열의 표현입니다.

  • +와 %20의 차이: 쿼리 문자열에서는 공백이 +로 인코딩되기도 하며(application/x-www-form-urlencoded 사양), 경로 부분에서는 %20이 쓰입니다. 둘 다 공백이지만 디코딩 방식을 잘못 잡으면 +가 그대로 남습니다.
  • 배열 표현은 서비스마다 다릅니다: 같은 “여러 값”이라도 tag=a&tag=b(반복), tag=a,b(쉼표 구분), tag[]=a&tag[]=b(대괄호)처럼 여러 방식이 있습니다. 프런트와 API의 전제가 어긋나면 한쪽만 값을 받습니다.
  • 인코딩 누락: 값에 &나 =가 들어 있는데 인코딩되지 않으면 거기서 별도 파라미터로 잘립니다.

JSON으로 바꿔 배열과 키의 모양을 확인하고, 인코딩된 값은 URL 인코드 / 디코드 도구로 원래 의미를 보면 이런 어긋남을 일찍 발견할 수 있습니다.

실제 변환 결과

URL 파라미터 JSON 변환 도구에 다음 URL을 입력한 결과입니다.

https://example.com/?utm_source=news&utm_medium=email&tag=a&tag=b&q=%E6%9D%B1%E4%BA%AC&empty=&flag
{
  "utm_source": "news",
  "utm_medium": "email",
  "tag": ["a", "b"],
  "q": "東京",
  "empty": "",
  "flag": ""
}
  • 값은 디코딩됩니다: q=%E6%9D%B1%E4%BA%AC는 "東京"으로 표시됩니다
  • 같은 이름의 키는 배열이 됩니다: tag=a&tag=b는 ["a", "b"]입니다
  • 값이 빈 키와 =가 없는 키는 모두 빈 문자열이 됩니다: empty=와 flag는 구분되지 않습니다
  • 값은 모두 문자열입니다: page=2도 숫자 2가 아니라 "2"가 됩니다
  • a[]=1&a[]=2 같은 대괄호 표기는 펼쳐지지 않습니다: 키 이름이 "a[]" 그대로이고 값이 배열이 됩니다. b[x]=3도 "b[x]": "3"입니다. 중첩된 객체로 읽고 싶다면 받는 쪽 프레임워크의 해석과 견주어 보세요
  • URL 전체로도, ? 뒤쪽만으로도, a=1&a=2 같은 쿼리 부분만으로도 입력할 수 있습니다

마치며

URL 파라미터는 작은 입력 실수로 측정이나 API 동작이 바뀝니다. 긴 URL을 그대로 바라보기보다 JSON으로 분해해 확인하는 것만으로 리뷰의 정확도가 올라갑니다.

자주 묻는 질문

같은 키가 여러 개 있는 URL은 어떻게 처리되나요?

tag=security&tag=api처럼 동일 키가 여러 개 있는 경우, JSON화하면 배열로 확인할 수 있습니다. API 측이 tag=security,api(쉼표 구분)를 기대하는데 여러 개로 보내는 어긋남을 찾기 쉬워집니다. 사양에 맞춰 어느 형식인지 확인하세요.

UTM 파라미터에서 주의할 점은?

utm_source·utm_medium·utm_campaign은 값이 그대로 측정 결과가 됩니다. 대소문자나 표기 흔들림(Twitter와 twitter 등)이 있으면 다른 캠페인으로 집계됩니다. 공개 전에 JSON화해 명명 규칙에 맞는지 확인하면 안전합니다.

값이 %20처럼 인코딩되어 읽을 수 없습니다

URL 파라미터의 값은 예약 문자를 포함하면 퍼센트 인코딩됩니다. %20은 스페이스, %2F는 슬래시입니다. URL 인코드·디코드 도구로 디코드하면 원래 문자열의 의미를 확인할 수 있습니다.

공백이 +로 되어 있는 이유는 무엇인가요?

쿼리 문자열에서는 application/x-www-form-urlencoded 사양에 따라 공백이 +로 인코딩되기도 합니다. 반면 경로 부분이나 RFC 3986에 맞는 인코딩에서는 %20이 쓰입니다. 둘 다 공백을 나타내지만 디코딩할 때 이 차이를 고려하지 않으면 +가 그대로 남으므로 값을 다루는 시스템에 맞춰 확인하세요.