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