설정

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

다음 단계를 따르세요:

Wink에서 사용자 계정을 등록하세요.
제휴사 계정 생성. 애플리케이션을 연결하려면 필요합니다. 자세한 내용은 Studio란 무엇인가를 참조하세요.
애플리케이션 생성 후 2단계에서 생성한 제휴사 계정과 연결하세요. 서버 간 API 통합의 경우 클라이언트 유형으로 MACHINE_2_MACHINE을 선택하세요.
Application을 생성한 후, 클라이언트 ID와 비밀 키를 즉시 복사하여 저장하세요 — 비밀 키는 한 번만 표시되며 다시 조회할 수 없습니다.

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을 클릭하세요.
클라이언트 ID와 클라이언트 비밀 키를 입력하고 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 필드에 애플리케이션이 생성한 클라이언트 ID를 입력하세요.
Client Secret 필드에 애플리케이션이 생성한 클라이언트 비밀 키를 입력하세요.
Scope 필드에 통합에 필요한 공백 구분 범위를 입력하세요 (예: inventory.read inventory.write inventory.remove). 전체 목록은 scope reference를 참조하세요.
Client Authentication 필드를 Send as Basic Auth header로 설정하세요.
Get New Access Token 버튼을 클릭하여 토큰을 받아 저장하세요.
Wink API 컬렉션 내 모든 API 호출에서 인증 탭이 Inherit auth from parent로 설정되어 있어야 모든 호출에 토큰이 포함됩니다.