채널 오픈 신청 때 하는 기본 검증의 적용 범위를 채널 유형별로 정리했습니다. 레거시 채널은 숙소 대표 이미지·카테고리와 객실 조건 전체를 검증하지 않습니다. 검증에 하나라도 실패하면 자동 반려되는 동작과 자동 승인·검수 처리 방식은 그대로입니다.

주요 변경사항​

1. 레거시 채널 검증 범위​

레거시 채널(부킹닷컴 · 아고다 · 익스피디아 · 트립닷컴 · 에어비앤비)에 적용되는 검증 항목은 아래와 같습니다.

이전 문서는 숙소 대표 이미지 · 카테고리 · 객실 이미지만 검증하지 않는다고 안내해, 나머지 객실 조건은 레거시 채널에도 적용되는 것처럼 읽혔습니다. 실제로는 객실 조건 전체가 적용되지 않습니다.

또한 레거시 채널을 requires_cms_authorization=false 채널로 설명하던 문구를 삭제했습니다. 에어비앤비는 레거시 채널이지만 이 값이 true입니다.

2. 플러스 채널 검증 기준 문구 보완​

동작은 바뀌지 않았으며, 기준 설명을 더 정확하게 고쳤습니다.

3. 가이드 업데이트​

• 직연동 레거시 채널 오픈: 검증 항목별 적용 여부 표를 추가했습니다.
• 플러스 채널 오픈: 위 검증 기준 문구를 반영했습니다.

문의​

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

• 기술 문의: techsupport@onda.me

숙소의 인허가 서류와 사업자등록증을 API로 제출하고, ONDA의 검수 결과를 조회할 수 있습니다. 플러스 채널은 인허가 서류와 사업자등록증이 모두 승인(confirm)된 숙소만 오픈할 수 있으므로, 플러스 채널을 판매하려면 채널 오픈 신청 전에 두 서류를 제출해 주세요.

주요 변경사항​

1. 신규 API 3개​

경로 prefix는 /gds/vendor/properties입니다.

2. 제출 서류​

서류마다 요청을 하나씩 보내며, type으로 서류 종류를 지정합니다.

• 파일은 base64 문자열로 data.file에 담습니다. jpeg, png, gif, webp, pdf를 지원하며, 파일 1개당 최대 10MB, 이미지는 450x200 픽셀 이상이어야 합니다.
• 사업자등록증의 사업자 구분이 법인(corporation)이면 상호·사업장 소재지·업태·종목도 필수입니다.

3. 검수 흐름​

제출한 요청은 pending으로 접수되고, ONDA 검수 후 confirm(승인) 또는 reject(반려)로 바뀝니다. 반려 사유는 조회 API의 reason에서 확인할 수 있습니다. 같은 서류를 검수 중에 다시 제출하면 이전 요청은 자동으로 반려되고 새 요청이 검수 대상이 됩니다.

서류는 종류별로 1건만 반영됩니다. 같은 종류를 여러 번 제출해도 가장 최근에 승인된 1건만 현재 서류가 되며, 새 서류가 승인되기 전까지는 기존 승인 서류가 유지됩니다.

4. 가이드 업데이트​

• 최초 판매 준비: 숙소 생성 다음 단계로 라이센스 제출을 추가했습니다. 분량이 늘어 개요 · 콘텐츠 생성 · 라이센스 제출 · 요금·재고 전송 4개 페이지로 나눴습니다.
• 라이센스 제출: 서류별 필수 항목, 파일 규칙, 검수 상태, 인허가 유형 코드를 정리한 새 가이드입니다.
• 플러스 채널 오픈: 인허가 서류와 사업자등록증 모두 승인돼야 한다는 선행 조건을 추가했습니다.

5. 최초 판매 준비 섹션 위치 변경​

기존 최초 판매 준비 페이지의 섹션이 아래 페이지로 옮겨졌습니다. 내용은 바뀌지 않았으며, 섹션 링크를 북마크해 두셨다면 새 위치로 바꿔 주세요.

문의​

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

• 기술 문의: techsupport@onda.me

API 문서에 적혀 있던 개발 환경 서버 주소를 플레이스홀더로 바꿨습니다. 실제 서버 주소와 API 동작은 바뀌지 않았으므로, 연동 중인 시스템은 수정할 필요가 없습니다.

주요 변경사항​

1. 서버 주소를 플레이스홀더로 표기​

API 레퍼런스의 엔드포인트와 cURL 예제에 실제 주소 대신 아래 플레이스홀더가 표시됩니다. 경로 prefix(/gds/diglett, /gds/vendor)는 그대로입니다.

• {base_url}: ONDA 서버의 베이스 URL입니다. 환경(개발/운영)별 주소는 ONDA 담당자가 안내합니다.
• {vendor_base_url}: 공급사가 구현하고 ONDA가 호출하는 API의 서버 주소로, 공급사가 지정합니다. Vendor API 3.0 웹훅과 같은 표기입니다.

cURL 예제를 복사해 쓸 때는 플레이스홀더를 안내받은 주소로 바꿔 호출해 주세요.

2. 환경별 URL 안내​

소개와 FAQ의 환경 표에서 개발 환경 주소가 "연동 시작 시 ONDA 담당자가 안내"로 바뀌었습니다. 운영 환경 안내는 기존과 같습니다.

문의​

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

• 기술 문의: techsupport@onda.me

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만 안내되어 있었습니다.

4. 가이드 정리​

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

문의​

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

• 기술 문의: techsupport@onda.me

기존에는 예약 전송(POST /bookings)으로 보낸 값 중 일부를 예약 조회로 다시 확인할 수 없었습니다. 이번 변경으로 전송 페이로드의 모든 항목이 조회 응답에도 나옵니다. 더불어 예약 전송 문서에 잘못 적혀 있던 필드 타입 3건을 실제 기준으로 정정했습니다.

주요 변경사항​

1. 예약 조회 응답에 필드 12개 추가​

GET /gds/vendor/booking/{vendor_booking_number}

선택 필드는 값이 없으면 null이 아니라 키 자체가 빠집니다. 응답 파싱 시 키 존재 여부로 판단해 주세요.

금액 필드가 세 개로 늘어난 만큼 기준도 함께 정리했습니다.

2. 예약 조회 응답의 type 필드 표현 변경​

예약 전송 페이로드와 동일한 방식으로 통일한 것입니다. 실제로 값이 없는 예약은 운영 데이터에 없어 응답이 바뀌지는 않지만, 파싱 로직이 null 비교를 한다면 확인이 필요합니다.

3. 예약 전송 문서 오류 정정​

전송하는 값은 바뀌지 않았습니다. 문서가 실제와 달랐던 것을 실제 기준으로 고쳤습니다. 문서를 보고 구현했다면 확인이 필요합니다.

POST /bookings

• channel_id, total_amount는 처음부터 숫자로 전송해 왔습니다. 문서 예시만 잘못 적혀 있었습니다.
• channel_booking_number는 판매 채널이 자기 예약 번호를 주지 않는 경우 키가 빠질 수 있어 선택으로 바꿨습니다.

PUT /bookings/{vendor_booking_number}/modify의 total_amount도 같은 문서 오류라 함께 number로 정정했습니다.

관련 문서​

• 예약 조회
• 예약 생성 · 예약 변경
• 직연동 채널 예약 · 플러스 채널 예약

문의​

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

• 기술 문의: techsupport@onda.me

신규 연동을 위한 Vendor API 3.0 문서가 공개되었습니다. 기존 Vendor API 1.5는 그대로 지원되며, 상단 메뉴 벤더 API에서 두 버전을 선택할 수 있습니다.

1.5에서 달라진 점​

콘텐츠 전송 방향 반전​

기존에는 ONDA가 공급사 API를 GET으로 호출해 콘텐츠를 가져갔습니다. 3.0에서는 공급사가 ONDA로 직접 전송합니다.

• 생성 POST /gds/vendor/properties
• 수정 PATCH /gds/vendor/properties/{vendor_property_id}

조회(GET)는 비상용 옵션으로 유지됩니다.

요금제 모델 신설​

요금제가 객실타입 × 요금제 모델의 결합으로 정의됩니다. 요금제 모델은 숙소 단위로 생성하며, standalone은 숙소당 1개 필수, package는 개수 제한이 없습니다.

요금·재고 전송 분리​

• 요금·영업일 → POST .../ari (요금제 단위)
• 재고 → POST .../ari/avails (객실타입 단위 통합 재고)

두 호출 모두 전 채널 공통 값과 채널별 값(channels[])을 한 번에 담아 전송합니다.

채널 API 추가​

채널 탐색, 오픈 신청, 채널별 설정, 숙소·객실·요금제 매핑을 API로 처리합니다.

문서 구성​

HUB API(공급사 → ONDA)에서 공급사는 클라이언트이고, 공급사 API(ONDA → 공급사)에서는 공급사가 서버입니다. 예약 생성·확정·변경·취소와 취소환불 정책 조회는 공급사가 직접 구현해야 하는 엔드포인트입니다.

AI 개발 지원​

AI 개발 지원 페이지에서 Vendor API 3.0 전용 컨텍스트 파일(Claude Code · Cursor · Windsurf)을 내려받을 수 있습니다.

참고​

• 개발(alpha) 환경 베이스 URL은 연동 시작 시 ONDA 담당자가 안내합니다
• 운영 환경 URL과 access token은 연동 계약 후 ONDA 담당자가 안내합니다

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

주요 변경사항​

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

Vendor API의 개발(alpha) 환경 전용 서버 URL이 Channel API와 분리된 Vendor API 전용 주소로 변경되었습니다. 변경된 주소는 ONDA 담당자가 안내합니다.

영향 범위: 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