API 버전에 관련한 명칭 개선 제안
현재 Toss Payments API 문서에서는 다음 두 가지가 모두 “API 버전”이라는 동일한 용어로 불리고 있어, 개발자분들 사이에서 혼동이 발생하는 사례가 늘어나고 있습니다.
- api.tosspayments.com/v1, /v2 등 엔드포인트 URL 상의 버전
- 개발자센터에서 설정하는 요청/응답 전문(스펙) 버전
두 개념이 성격상 다름에도 불구하고 같은 이름으로 표기되다 보니, 실제 개발 과정에서 헷갈리는 경우가 잦습니다.
이를 방지하기 위해 문서에서는 아래와 같이 용어를 구분해 표기하는 것을 제안드립니다.
- API 버전: api.tosspayments.com/v1, /v2 등 엔드포인트 URL에 포함된 버전을 지칭
- 전문 버전: 개발자센터에서 설정하는 요청/응답 전문(스펙) 버전을 지칭
이렇게 명확히 구분하면, 외부 개발자들이 “엔드포인트 버전”과 “전문 스펙 버전”을 혼동하지 않고 이해할 수 있을 것으로 기대됩니다.
2 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
네 의견 감사합니다. 내부 논의해볼게요