본문으로 건너뛰기

채널 인증 URL 조회

GET 

/gds/vendor/channels/:channel_id/authorization

  • 에어비앤비 전용입니다. 채널 메타의 requires_cms_authorizationtrue인 채널에서만 사용하며, 현재 해당하는 채널은 에어비앤비뿐입니다. 다른 채널에 호출하면 403이 반환됩니다.
  • 에어비앤비는 숙소마다 호스트 계정의 OAuth 승인이 필요합니다. 이 API로 인증 URL을 발급받아 호스트를 이동시키고, 승인이 끝나야 객실·요금제 매핑을 진행할 수 있습니다.
  • 호스트가 인증을 마치면 redirect_url?auth_result=success|fail이 붙어 복귀합니다.
  • auth_result는 화면 힌트이며, 연동 완료 판정은 숙소 매핑 조회의 channel_property_id 존재 여부를 기준으로 합니다.
  • 발급된 인증 URL은 1시간 내에 사용해야 하며, 만료되면 새로 발급해야 합니다. 호스트가 버튼을 누르는 시점에 발급하세요.
  • 인증은 숙소 단위로 진행되므로, 같은 호스트 계정이 여러 숙소를 운영해도 숙소마다 반복해야 합니다.

Request

Responsesapplication/json

채널 인증 URL 조회 성공