이번 업데이트에서는 Vendor API 개발(alpha) 환경 서버 URL이 변경되고, Channel Create Reservation API에 중요한 에러 처리 가이드가 추가되었습니다. 또한 API 레퍼런스 페이지 전반의 가독성과 시각적 일관성이 개선되었습니다.

주요 변경사항​

1. Vendor API 개발(alpha) 환경 서버 URL 변경​

Vendor API의 개발(alpha) 환경 전용 서버 URL이 아래와 같이 변경되었습니다.

• 변경 전: https://dapi.tport.dev
• 변경 후: https://vendor.dapi.tport.dev

영향 범위: Vendor API 전체 5개 스펙 (숙소 생성 / 숙소 정보 관리 (Sync) / 숙소 정보 관리 (Push) / 예약 / 기타 API)

2. Channel Create Reservation: 400 에러 처리 안내 추가​

Channel Create Reservation API 문서 상단에 400 channel booking number is exist already 에러 수신 시 처리 방법이 명시되었습니다.

동일 channel_booking_number로 예약 생성 요청이 중복 수신되면 반환되는 이 에러는 즉시 실패 처리(예: 결제 취소)하지 마시고, 아래 절차로 실제 예약 상태를 재확인해야 합니다.

1. 수신한 channel_booking_number로 Check Reservation API 호출 (type=channel_booking_number 쿼리 파라미터 사용)
2. 응답에 예약 정보가 존재하면 예약 성공으로 간주하고 내부 상태 동기화
3. 예약 정보가 없으면 실제 실패이므로 결제 취소 등 통상적인 실패 처리 진행

3. API 레퍼런스 페이지 UI/UX 개선​

API 문서 전반이 ONDA 디자인 시스템에 맞춰 정비되었습니다.

• Content-type 뱃지: Request / Responses 헤딩 우측에 application/json 뱃지가 표시되어 한눈에 파악 가능
• Response 코드 탭 위치: description 설명과 같은 행에 정렬되어 세로 공간 효율 향상
• 중첩 스키마 collapsible: 객체·배열 필드의 접힘 블록에 간격 및 애니메이션이 개선되어 가독성 상승
• 스키마 표시 정리: REQUIRED 뱃지 위치, 빈 example 자동 숨김, description에 등장하는 enum 값 보존 등 소소한 가독성 개선

문의​

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

• 기술 문의: techsupport@onda.me

Vendor API 개발 가이드에 에러 코드 페이지가 추가되었습니다.

공급사(Vendor)는 온다(ONDA Hub)로부터 API 요청을 받아 처리에 실패하는 경우, 이 페이지에 정의된 표준 에러 응답 포맷을 사용해야 합니다.

주요 내용​

에러 응답 포맷​

{
  "code": "4000",
  "error": "No rooms available for booking"
}

code와 error 두 필드 모두 필수이며, error 값은 정의된 영문 메시지를 그대로 사용해야 합니다.

에러 코드 목록​

총 12개의 에러 코드가 카테고리별로 정의되어 있습니다.

특히 BUSINESS_ERROR 코드는 관련 엔드포인트(Create Reservation, Check Reservation, Cancel Reservation, Confirm Reservation)와 함께 안내되어 상황별로 어떤 코드를 반환해야 하는지 명확하게 파악할 수 있습니다.

자세한 내용은 에러 코드 가이드를 참고해 주세요.

문의​

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

• 기술 문의: techsupport@onda.me

GNB(상단 네비게이션 바)에 "AI 개발 지원" 메뉴가 추가되었습니다. Claude Code, Cursor, Windsurf 등 AI 개발 도구에 ONDA API 전체 문서를 컨텍스트로 주입하면 더 정확한 코드 제안과 API 이해를 받을 수 있습니다.

주요 변경사항​

AI 개발 지원 전용 페이지 (/ai-tools)​

벤더 API와 채널 API 개발자가 각자의 연동 범위에 맞는 컨텍스트 파일만 선택해 다운로드할 수 있는 전용 페이지가 추가되었습니다.

제공 파일​

각 파일은 공통 가이드(Introduction, Getting Started, FAQ)와 해당 API 전용 문서 전체를 포함합니다.

활용 방법​

Claude Code

# 다운로드한 파일을 프로젝트 루트에 저장
mv ~/Downloads/ONDA-VENDOR-CLAUDE.md ./CLAUDE.md
# Claude Code가 자동으로 ONDA Vendor API 컨텍스트를 읽어들입니다

Cursor

# .cursor/rules/ 디렉터리 생성 후 파일 이동
mkdir -p .cursor/rules
mv ~/Downloads/onda-vendor.mdc .cursor/rules/
# Cursor AI가 ONDA Vendor API 컨텍스트를 자동으로 로드합니다

Windsurf

# 다운로드한 파일을 프로젝트 루트에 저장
mv ~/Downloads/ONDA-VENDOR.windsurfrules ./.windsurfrules
# Windsurf AI가 ONDA Vendor API 컨텍스트를 자동으로 인식합니다

문의​

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

• 기술 문의: techsupport@onda.me

채널 API 및 벤더 API 문서 페이지 상단에 "Markdown 복사" 버튼이 추가되었습니다. 개발자가 API 문서 내용을 AI 어시스턴트나 마크다운 에디터에 빠르게 붙여넣을 수 있도록 개선되었습니다.

주요 변경사항​

Markdown 복사 버튼​

• 위치: 채널 API / 벤더 API 문서 페이지 상단 우측
• 동작: 버튼 클릭 시 현재 페이지의 내용이 Markdown 형식으로 클립보드에 복사됩니다
• 피드백: 복사 성공 시 버튼이 2초간 "복사됨" 상태로 전환된 후 원복됩니다

활용 예시​

복사된 Markdown을 다음과 같이 활용할 수 있습니다:

• ChatGPT, Claude 등 AI 어시스턴트에 붙여넣어 API 연동 관련 질문
• Notion, Obsidian 등 마크다운 에디터에 문서 내용 저장
• 개발팀 내 기술 문서 작성 시 참고 자료로 활용

적용 범위​

• /docs/api/channel/ 하위 모든 API 문서 페이지
• /docs/api/vendor/ 하위 모든 API 문서 페이지

일반 가이드 문서(/docs/)에는 버튼이 표시되지 않습니다.

문의​

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

• 기술 문의: techsupport@onda.me

숙박상품 상세 조회(Get Property Detail) API의 설명(descriptions) 필드에 최대 글자수 제한이 명확히 표시되어 채널 파트너사가 데이터를 UI에 표기할 때 참고할 수 있도록 명시되었습니다.

주요 변경사항​

글자수 제한 추가​

다음 4개의 설명 필드에 최대 글자수 제한이 명시되었습니다:

API 응답 예시​

descriptions:
  property:
    type: string
    description: 숙소 소개 (최대 4000자)
  reservation:
    type: string
    description: 숙소 예약 정보 (최대 4000자)
  notice:
    type: string
    description: 숙소 별도 공지사항 (최대 4000자)
  refunds:
    type: string
    description: 숙소 취환불 정책 정보 (최대 1000자)

기대 효과​

• 채널 파트너사가 UI 표기 시 적절한 글자수 제한을 참고 가능
• API 연동 시 발생할 수 있는 데이터 오류 사전 방지
• 더 명확한 API 문서로 개발 편의성 향상

관련 문서​

• Channel API - 숙박상품 상세 조회

문의​

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

• 기술 문의: techsupport@onda.me

추가인원 요금 가이드의 객실 검색 기준이 개선되었습니다. 이제 최대인원 기준으로 검색하여 총 이용 인원이 투숙할 수 있는 모든 객실을 찾을 수 있습니다.

주요 변경사항​

검색 기준 변경​

검색 결과 예시 추가​

4명으로 검색 시 최대인원이 4명 이상인 객실이 모두 검색됩니다:

기대 효과​

• 더 많은 객실 옵션을 고객에게 제공 가능
• 기준인원이 적지만 최대인원이 충분한 객실도 검색 가능
• 파트너사의 판매 기회 확대

관련 문서​

• 추가인원 요금 가이드

문의​

가이드 내용에 대해 궁금하신 사항이 있으시면 언제든지 문의해 주세요:

• 기술 문의: techsupport@onda.me

Channel API 개발 가이드 문서가 개선되었습니다. 파트너사가 API 연동 시 자주 문의하는 내용을 바탕으로 가이드를 보강했습니다.

주요 변경사항​

추가인원 요금 가이드 신규 추가​

추가인원 요금(Extra Charge) 처리에 대한 가이드가 새롭게 추가되었습니다.

• 문서 위치: 추가인원 요금 가이드
• 주요 내용:
  • 추가인원 요금 필드를 사용하지 않는 이유
  • 올바른 객실 검색 방법 (기준인원 기반)
  • 예약 요청 시 주의사항
  • 고객 안내 필수사항

취소환불 정책 가이드 개선​

기존 취소환불 정책 가이드가 더욱 명확하게 개선되었습니다.

• 문서 위치: 취소환불 정책 가이드
• 개선 내용:
  • 핵심 요약 섹션 추가
  • Static Policy vs Dynamic Policy 비교 표 추가
  • 3단계 구현 가이드 추가 (검색 → 예약직전 → 취소처리)
  • API 필드 정보 보강

관련 문서​

• 추가인원 요금 가이드
• 취소환불 정책 가이드
• Channel API 소개

문의​

가이드 내용에 대해 궁금하신 사항이 있으시면 언제든지 문의해 주세요:

• 기술 문의: techsupport@onda.me

더 나은 개발 가이드를 제공하기 위해 지속적으로 개선하겠습니다.

ONDA API 문서가 ONDA Partner Developer Center로 통합 이전되었습니다.

주요 변경사항​

기존에 분리되어 운영되던 Vendor API와 Channel API 문서가 하나의 통합 플랫폼으로 통합되었습니다.

기존 문서 사이트 (운영 종료)​

다음 문서 사이트는 2025년 12월 31일 이후로 더 이상 운영되지 않습니다:

• Vendor API 문서: https://onda-vendor-api-kr.readme.io
• Channel API 문서: https://onda-channel-api-kr.readme.io

새로운 통합 문서 사이트​

앞으로 모든 ONDA API 문서는 ONDA Partner Developer Center에서 제공됩니다:

• 통합 문서 사이트: https://developers.onda.me (예정)
• Vendor API: Vendor API 문서
• Channel API: Channel API 문서

새로운 Developer Center의 장점​

통합된 경험​

• Vendor와 Channel API를 한 곳에서 확인
• 일관된 UI/UX
• 통합 검색 기능

개선된 콘텐츠​

• 더욱 상세한 가이드
• 실용적인 예제 코드
• 인터랙티브한 플로우차트

추가 리소스​

• 시작하기 가이드
• 용어 정리
• ONDA Hub 소개

북마크 업데이트 안내​

기존 문서 URL을 북마크하신 경우, 새로운 Developer Center URL로 업데이트해 주시기 바랍니다.

문의​

문서 이전과 관련하여 궁금하신 사항이 있으시면 언제든지 문의해 주세요:

• 기술 문의: techsupport@onda.me
• 파트너 신청: contact@onda.me

ONDA Partner Developer Center에서 더 나은 개발 경험을 제공하겠습니다.