본문으로 건너뛰기

API 코드 예제 cURL 통일 및 인증 안내 정정

API 레퍼런스의 코드 예제와 인증·환경 안내를 실제 연동 방식에 맞게 정리했습니다.

주요 변경사항​

1. 인증 안내 정정 (Channel API 연동 중인 파트너 확인 필요)​

FAQ의 Channel API 인증 안내가 실제 스펙과 달랐습니다.

  • 변경 전 (잘못된 안내): x-api-key, x-channel-key 두 헤더에 키를 담아 호출
  • 변경 후 (실제 스펙): Authorization 헤더 하나에 발급받은 채널별 인증키를 담아 호출
Authorization: {발급받은_인증키}

Vendor API(공급사 → ONDA 호출)도 같은 방식입니다. 별도의 토큰 발급(OAuth 등) 절차는 없습니다. 소개 페이지의 "OAuth 2.0" 표기도 삭제했습니다.

2. 코드 예제를 cURL로 통일​

Channel API, Vendor API 1.5, Vendor API 3.0의 모든 레퍼런스 페이지에서 코드 예제가 cURL 하나로 통일되었습니다.

  • 예제에 Authorization 헤더가 포함됩니다
  • 긴 URL과 요청 본문은 기본으로 줄바꿈되어 가로 스크롤 없이 확인할 수 있습니다
  • 문서 페이지에서 서버로 직접 요청을 보내던 Send 버튼은 제거되었습니다. cURL 예제를 복사해 터미널이나 API 클라이언트에서 호출해 주세요

3. 환경별 URL 안내 정리​

소개와 FAQ의 환경 URL이 API별로 정리되었습니다. 기존에는 Channel API URL만 안내되어 있었습니다.

API개발 환경운영 환경
Channel APIhttps://dapi.tport.dev개발 환경 테스트 완료 후 ONDA 담당자가 안내
Vendor API (3.0 / 1.5)https://vendor.dapi.tport.dev연동 계약 후 ONDA 담당자가 안내

4. 가이드 정리​

  • "ONDA Hub 소개" 페이지를 소개 페이지로 통합했습니다. 기존 주소는 자동으로 이동합니다
  • 용어 정리 페이지를 가이드 메뉴에 추가했습니다
  • 영문 사이트의 API 메뉴가 영어로 표시됩니다
  • 사이트 테마가 사용자의 시스템 설정(다크/라이트)을 따릅니다

문의​

API 연동에 대해 궁금하신 사항이 있으시면 언제든지 문의해 주세요: