계정 생성 및 API 키 발급
ONDA 개발자 포털에서 계정을 만들고 API 자격 증명을 발급받으세요.
ONDA Platform Engineering 관리
계정 생성 및 API 키 발급
ONDA Channel API를 사용하려면 개발자 포털에서 계정을 생성하고 API 자격 증명을 발급받아야 합니다. 가입부터 키 발급까지 전 과정이 셀프서비스로 진행됩니다.
시작 단계
개발자 포털 가입
ONDA 개발자 포털에서 무료로 가입합니다. 신용카드 등록 없이 즉시 Sandbox 환경을 사용할 수 있습니다.
앱 생성
대시보드의 Apps 메뉴에서 앱을 생성합니다. 앱 단위로 자격 증명과 권한(scope)이 관리됩니다.
자격 증명 발급
앱 상세 화면에서 두 가지 인증 수단을 발급받을 수 있습니다:
- API Key (
X-Api-Key헤더): 서버 간(S2S) 호출의 기본 인증 방식 - Client ID / Client Secret: OAuth 2.0 Client Credentials 플로우로 Access Token(
oat_토큰, 30분 유효)을 발급받는 방식
중요: Client Secret과 API Key는 발급 시 1회만 표시됩니다. 안전한 곳에 저장하고 절대 외부에 노출하지 마세요.
환경 선택
개발/테스트용과 운영용 환경을 구분하여 사용하세요:
| 환경 | API Base URL | 용도 |
|---|---|---|
| Sandbox | https://sandbox.api.tport.dev/channel/v1 | 개발 및 테스트 |
| Production | https://api.tport.dev/channel/v1 | 실제 서비스 |
Sandbox 환경에서는 Mock 데이터로 응답하며 실제 예약이 발생하지 않습니다.
개발/운영 환경
Sandbox 환경
- 실제 데이터에 영향을 주지 않는 테스트 환경
- Mock 숙소·예약 데이터로 전체 플로우 테스트 가능
- 과금 없음
- Rate Limit: 분당 60건
Production 환경
- 실제 숙소 데이터 및 예약 처리
- 보증금(₩500,000) 충전 후 잔액 범위 내 예약
- Rate Limit: 분당 600건 (Starter)
- 응답 헤더(X-RateLimit-Limit/Remaining/Reset)로 잔여량 확인 가능
운영 전환 조건과 비용은 채널 등급을 참고하세요.
다음 단계
계정 생성이 완료되었다면:
- 첫 API 호출에서 OAuth 인증을 테스트하세요
- OAuth 2.0 인증에서 인증 체계를 자세히 알아보세요
- OpenAPI 명세에서 사용 가능한 API를 확인하세요
자주 묻는 질문
Q. Client Secret을 분실했습니다. 어떻게 하나요? A. 개발자 포털의 앱 상세 화면에서 Secret을 재발급하세요. 기존 Secret은 즉시 무효화됩니다.
Q. 여러 개의 앱을 운영할 수 있나요? A. 네, 서비스별로 별도의 앱을 생성할 수 있습니다. 각 앱은 독립적인 API 자격 증명을 가집니다.
Q. Sandbox와 Production 환경의 자격 증명이 다른가요? A. 네, 환경별로 별도의 자격 증명을 사용합니다. 개발자 포털에서 환경별로 발급받으세요.