라이센스 제출
POST/gds/vendor/properties/:vendor_property_id/licenses
- 숙소의 인허가 서류(
permit) 또는 사업자등록증(business)을 제출합니다. 요청 하나에는 서류 한 건을 담고type으로 서류 종류를 지정합니다. - 영업신고증, 관광사업 등록증, 농어촌민박사업자 신고확인증 등은
permit으로 제출합니다.data.type에는 인허가 유형 코드를 넣습니다. permit제출 시data.issuer는 필수이고data.status는 선택입니다.data.issuer에는 서류에 표시된 발급 기관 이름을 그대로 입력합니다.- 서류 정보와 파일을
data에 담습니다. 파일은 파일명 없이 base64로 인코딩한 문자열로 보냅니다. - API는 파일 내용을 보고 형식을 판별합니다. 지원 형식은 JPEG, PNG, GIF, WebP, PDF입니다. HEIC와 AVIF는 지원하지 않습니다. 이미지는 가로 450픽셀, 세로 200픽셀 이상이어야 하며 모든 파일은 1개당 최대 10MB입니다.
business에서data.type이corporation(법인)이면data.name,data.address,data.industry,data.category도 필수입니다.personal(개인)이면 선택입니다.- ONDA는 요청을
pending으로 접수하고 검수를 마치면confirm(승인) 또는reject(반려)로 처리합니다. - 검수 대기 중인(
pending) 요청과 같은 종류의 서류를 다시 제출하면, API는 이전 요청을 반려(reject)하고reason에Superseded by request {새 요청 ID}를 기록합니다. 새 요청이400이나422로 실패하면 이전 요청은 계속 검수 대기 상태입니다. - 플러스 채널을 열려면
permit과business가 모두 승인(confirm)되어야 합니다. ONDA는 서류 종류별로 가장 최근에 승인한 한 건을 사용합니다. 새 서류가 승인될 때까지는 이전 서류가 적용됩니다.
Request
Responsesapplication/json
- 200
- 400
- 401
- 404
- 413
- 422
접수한 서류 제출 요청을 반환합니다.
Bad Request. 필수 항목이 누락되었거나 값의 형식이 올바르지 않을 때 반환합니다. 지원하지 않는 type, 코드 목록에 없는 data.type, 자릿수나 체크섬이 맞지 않는 사업자등록번호, 미래 날짜, base64로 읽을 수 없는 파일이 여기에 해당합니다. 법인의 경우 data.name(상호), data.address(사업장 소재지), data.industry(업태), data.category(종목) 중 누락된 항목이 있어도 400을 반환합니다.
Unauthorized
Not Found. vendor_property_id가 이 공급사에 연결된 숙소의 ID가 아닐 때 반환합니다.
Payload Too Large. 요청 본문이 너무 클 때 반환합니다.
Unprocessable Entity. 지원하지 않는 파일 형식(HEIC, AVIF 등)이면 Unsupported file format, 이미지가 450x200 픽셀보다 작으면 Image must be at least 450x200 pixels, 이미지를 JPG로 변환하지 못하면 Image conversion failed를 반환합니다.