Setup
이 문서에서는 개발자로서 빠르게 설정을 완료하고 Wink에서 API 테스트를 시작하는 방법을 보여줍니다.
다음 단계를 따르세요.
- 등록하다 Wink의 사용자 계정
- 생성하다 여행사 계정 또는 제휴 계정.
- 신청서 만들기 2단계에서 만든 계정과 연결합니다.
- 당신이 당신의 것을 만든 후
Application
클라이언트 ID와 클라이언트 비밀번호를 안전한 곳에 저장하세요.
캐나다
섹션 제목: “캐나다”Wink에서는 모든 이미지 및 비디오 자료에 Cloudinary를 사용합니다. 여행 관련 자료에 접속하시면 Cloudinary의 모든 고급 기능을 이용하실 수 있습니다.
우리의 cloud_name
이다 traveliko
.
클라우디너리
섹션 제목: “클라우디너리”우리가 지원하는 모든 여행 인벤토리 유형에 대해 다음과 같은 중첩 JSON 배열이 있습니다.multimedias
멀티미디어 항목의 JSON은 다음과 같습니다.
{ "multimediaIdentifier": "multimedia-1", "identifier": "partners/radisson_blu_logo", "type": "IMAGE", "width": "1024", "height": "768", "category": "1", "descriptions": [ { "name": "Lobby", "description": "Picture of the lobby", "language": "en" } ], "lifestyleType": "LIFESTYLE_BUSINESS", "attribution": [ { "url": "https://www.hilton.com", "name": "Hilton" } ]}
위의 강조된 줄은 Cloudinary 고유 ID를 보여줍니다.partners/radisson_blu_logo
원하는 형식, 품질, 크기로 이미지를 검색하는 데 필요한 것은 이것뿐입니다.
테스트
섹션 제목: “테스트”우리의로 향하세요아피스섹션을 클릭하고 작업하려는 API를 선택하세요.
API 문서
섹션 제목: “API 문서”당사 문서 사이트는 사이트 내에서 API 명령을 실행할 수 있도록 설정되어 있습니다.
이 예에서는 다음을 사용하고 싶습니다.Search Lookups (OAuth2)
API 호출.
:::팁[전문가 팁]
사용 편의성을 위해 통합자는 당사에서 지정한 엔드포인트를 사용하는 것이 좋습니다.OAuth2
. 해당 엔드포인트는 API 호출자를 예상하고 이미 어떤 계정을 사용하고 있는지 알고 있으므로 지정할 필요가 없습니다.companyIdentifier
URL에 추가하세요.
:::
- 사용하세요 조회 API 목적지나 호텔을 검색합니다.
- 왼쪽 탐색바에서 다음을 클릭하세요.
Authentication
. - 클라이언트 ID와 클라이언트 비밀번호를 입력하고 클릭하세요.
Get TOKEN
단추. - 자격 증명이 유효하면 API 키가 적용된 것을 볼 수 있습니다.
- 이제 조회 엔드포인트를 테스트할 수 있습니다.
우편 집배원
섹션 제목: “우편 집배원”Postman으로도 같은 작업을 할 수 있습니다.
- 다운로드 우편 집배원.
- 클릭해주세요
Download OpenAPI spec
상단에서 조회 API 페이지. - Postman으로 가져옵니다.
- 새로운 컬렉션으로 가져온 경우
Wink API
, 컬렉션 이름 옆에 있는 가로 줄임표(3개 점)를 클릭하고 클릭하세요.Edit
. - 에서
Authorization tab
, 설정하다Auth type
OAuth2로. - 필드 설정
Add auth data to
에게Request headers
. - 필드 설정
Header prefix
에게Bearer
. - 필드 설정
Token Name
Postman에 저장된 토큰의 이름을 원하는 대로 지정합니다. 예: Wink Staging. - 필드 설정
Grant type
에게Client Credentials
. - 필드 설정
Access token URL
https://staging-iam.wink.travel/oauth2/token으로 이동하세요. - 필드 설정
Client ID
앱이 생성한 클라이언트 ID에. - 필드 설정
Client Secret
앱이 생성한 클라이언트 비밀번호에. - 필드 설정
Scope
에게inventory.read inventory.write inventory.remove
. Wink에 필요한 범위는 모두 이것입니다. - 필드 설정
Client Authentication
에게Send as Basic Auth header
. - 클릭
Get New Access Token
토큰을 검색하여 저장하려면 버튼을 클릭하세요. - Wink API 컬렉션 아래의 모든 API 호출에 대해 인증 탭에 다음이 표시되는지 확인하세요.
Inherit auth from parent
즉, 모든 통화에 토큰이 포함됩니다.
:::팁[전문가 팁] 서버 도메인, 클라이언트 ID, 클라이언트 비밀번호를 환경 변수로 지정하는 것이 좋습니다. 이렇게 하면 스테이징 환경과 프로덕션 환경 사이를 쉽게 전환하고 생성한 모든 작업을 재사용할 수 있습니다. :::