콘텐츠로 이동

Setup

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

다음 단계를 따르세요.

  1. 등록하다 Wink의 사용자 계정
  2. 생성하다 여행사 계정 또는 제휴 계정.
  3. 신청서 만들기 2단계에서 만든 계정과 연결합니다.
  4. 당신이 당신의 것을 만든 후 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 명령을 실행할 수 있도록 설정되어 있습니다.

이 예에서는 다음을 사용하고 싶습니다.Search Lookups (OAuth2)API 호출.

:::팁[전문가 팁] 사용 편의성을 위해 통합자는 당사에서 지정한 엔드포인트를 사용하는 것이 좋습니다.OAuth2. 해당 엔드포인트는 API 호출자를 예상하고 이미 어떤 계정을 사용하고 있는지 알고 있으므로 지정할 필요가 없습니다.companyIdentifierURL에 추가하세요. :::

  1. 사용하세요 조회 API 목적지나 호텔을 검색합니다.
  2. 왼쪽 탐색바에서 다음을 클릭하세요. Authentication.
  3. 클라이언트 ID와 클라이언트 비밀번호를 입력하고 클릭하세요. Get TOKEN 단추.
  4. 자격 증명이 유효하면 API 키가 적용된 것을 볼 수 있습니다.
  5. 이제 조회 엔드포인트를 테스트할 수 있습니다.
조회 API 엔드포인트
샘플 검색 조회(OAuth2)

Postman으로도 같은 작업을 할 수 있습니다.

  1. 다운로드 우편 집배원.
  2. 클릭해주세요 Download OpenAPI spec 상단에서 조회 API 페이지.
  3. Postman으로 가져옵니다.
  4. 새로운 컬렉션으로 가져온 경우 Wink API, 컬렉션 이름 옆에 있는 가로 줄임표(3개 점)를 클릭하고 클릭하세요. Edit.
  5. 에서 Authorization tab, 설정하다 Auth type OAuth2로.
  6. 필드 설정 Add auth data to 에게 Request headers.
  7. 필드 설정 Header prefix 에게 Bearer.
  8. 필드 설정 Token Name Postman에 저장된 토큰의 이름을 원하는 대로 지정합니다. 예: Wink Staging.
  9. 필드 설정 Grant type 에게 Client Credentials.
  10. 필드 설정 Access token URL https://staging-iam.wink.travel/oauth2/token으로 이동하세요.
  11. 필드 설정 Client ID 앱이 생성한 클라이언트 ID에.
  12. 필드 설정 Client Secret 앱이 생성한 클라이언트 비밀번호에.
  13. 필드 설정 Scope 에게 inventory.read inventory.write inventory.remove. Wink에 필요한 범위는 모두 이것입니다.
  14. 필드 설정 Client Authentication 에게 Send as Basic Auth header.
  15. 클릭 Get New Access Token 토큰을 검색하여 저장하려면 버튼을 클릭하세요.
  16. Wink API 컬렉션 아래의 모든 API 호출에 대해 인증 탭에 다음이 표시되는지 확인하세요. Inherit auth from parent 즉, 모든 통화에 토큰이 포함됩니다.

:::팁[전문가 팁] 서버 도메인, 클라이언트 ID, 클라이언트 비밀번호를 환경 변수로 지정하는 것이 좋습니다. 이렇게 하면 스테이징 환경과 프로덕션 환경 사이를 쉽게 전환하고 생성한 모든 작업을 재사용할 수 있습니다. :::