설정

이 문서에서는 개발자로서 빠르게 설정하고 Wink에서 API를 테스트하는 방법을 보여줍니다.

다음 단계를 따르세요:

Wink에서 사용자 계정을 등록 하세요.
여행사 계정 또는 제휴사 계정 을 만드세요.
2단계에서 만든 계정과 연동할 애플리케이션을 생성 하세요.
Application을 생성한 후, client-id와 client secret을 안전한 곳에 저장하세요.

CDN

Wink에서는 모든 이미지 및 비디오 자산에 Cloudinary를 사용합니다. 여행 인벤토리에 접근할 때 Cloudinary의 모든 고급 기능을 완전히 이용할 수 있습니다.

우리의 cloud_name은 traveliko입니다.

Cloudinary

예시

지원하는 모든 여행 인벤토리 유형마다 multimedias라는 중첩된 JSON 배열이 있습니다. 멀티미디어 항목의 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를 보여줍니다. 이 ID만 있으면 원하는 형식, 품질, 크기로 이미지를 가져올 수 있습니다.

테스트

APIs 섹션으로 이동하여 작업할 API를 선택하세요.

API 문서

문서 사이트는 사이트 내에서 API 명령을 실행할 수 있도록 구성되어 있습니다.

이 예시에서는 Search Lookups (OAuth2) API 호출을 사용하려고 합니다.

Lookup API 를 사용하여 목적지 또는 호텔을 조회하세요.
왼쪽 네비게이션 바에서 Authentication을 클릭하세요.
client-id와 client secret을 입력하고 Get TOKEN 버튼을 클릭하세요.
자격 증명이 유효하면 API 키가 적용된 것을 확인할 수 있습니다.
이제 lookup 엔드포인트를 테스트할 수 있습니다.

Lookup API endpoint — *샘플 Search Lookups (OAuth2)*

Postman

Postman으로도 동일한 작업을 할 수 있습니다.

Postman 을 다운로드하세요.
Lookup API 페이지 상단에서 Download OpenAPI spec을 클릭하세요.
Postman에 가져오세요.
새 컬렉션 Wink API로 가져왔다면, 컬렉션 이름 옆의 가로 점 3개(더보기)를 클릭하고 Edit을 선택하세요.
Authorization 탭에서 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 필드에 앱이 생성한 Client ID를 입력하세요.
Client Secret 필드에 앱이 생성한 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로 설정되어 있어야 모든 호출에 토큰이 포함됩니다.