API 시작하기
인증 및 승인을 통해 Expedia 데이터 활용
Expedia Group 여행 플랫폼 API를 사용하려면 비밀번호로 보호되는 사용자 계정과 같은 API 클라이언트를 하나 이상 생성해야 합니다. 기본적으로 API 클라이언트는 API 요청을 수행하는 소프트웨어가 사용자의 소유임을 확인하고(인증) 각 클라이언트가 수행할 수 있는 API 요청 유형을 제한할 수 있습니다(승인).
샌드박스 기능으로 테스트
Fraud Prevention 서비스에서는 샌드박스 기능을 활성화하여 프로덕션 애플리케이션에 반영되지 않는 방식으로 API 결과를 테스트할 수 있습니다. API Explorer, Postman 또는 기타 도구에서 샌드박스별 로그인 정보를 사용하여 Fraud Prevention 서비스 API를 사용해 보고, 구성을 라이브로 전환하기 전에 테스트해 보세요.
샌드박스 환경에서 API를 테스트하는 방법에 대한 자세한 내용은 Fraud Prevention 샌드박스를 확인해 주세요.
API 클라이언트 생성
샌드박스 모드에서 시작하든, 바로 라이브 상태로 시작하든 관계없이 Expedia Group 콘솔에서 API 클라이언트를 생성하고 관리할 수 있습니다. API 클라이언트를 생성하기 전에 계정에 제품을 추가해야 합니다.
단계:
- 콘솔에서 왼쪽 하단 모서리에 있는 API 클라이언트 생성 링크를 클릭합니다.
- 새 API 클라이언트 생성 페이지에서 클라이언트에 포함된 제품을 기억하는 데 도움이 되는 이름과 설명을 클라이언트에 제공합니다.
- 사용 가능한 제품 목록에서 포함하려는 범위(API 요청 유형) 옆의 상자를 선택합니다. 최상위 수준의 상자를 선택하면 모든 하위 요소가 선택됩니다.
- 로그인 정보 가져오기를 클릭합니다.
- 로그인 정보를 복사하여 안전한 위치에 저장합니다.
참고: API 로그인 정보는 클라이언트가 생성될 때만 표시되므로 계속 진행하기 전에 이 정보를 복사하고 저장해야 합니다. 해당 정보를 다시 표시할 수는 없습니다.
필요한 만큼 API 클라이언트를 생성할 수 있습니다. 각 클라이언트에 특정 권한을 부여하여 각각의 해당 소프트웨어 서비스가 Expedia Group 여행 플랫폼에서 수행할 수 있는 작업을 제한할 수 있습니다.
제품 및 범위
모든 API 클라이언트는 단일 파트너 계정 내에서 작동합니다. 계정에 제품을 추가하면 API 클라이언트에 포함할 수 있습니다. 단일 API 클라이언트를 생성하고 하나 이상의 제품에 대한 액세스 권한을 부여할 수 있습니다.
각 제품은 특정 요청 유형에 대한 액세스 권한을 부여하는 일련의 범위를 포함합니다. 할당하는 범위는 해당 클라이언트가 수행할 권한이 있는 작업을 제어합니다. 여러 소프트웨어 서비스에서 API 요청을 수행하는 경우 각 서비스에 대해 별도의 API 클라이언트를 생성하고 각 API 클라이언트에 필요한 범위만 선택하는 것이 좋습니다.
클라이언트 로그인 정보
각 API 클라이언트에는 사용자 이름 및 비밀번호와 유사한 인증용 ID와 암호가 제공됩니다. 로그인 정보는 클라이언트가 생성될 때만 표시되므로 계속 진행하기 전에 이 정보를 복사하고 저장해야 합니다.
API 클라이언트 로그인 정보를 보호해야 합니다! GitHub, 클라이언트측 코드 등과 같이 공개적으로 액세스할 수 있는 영역에 클라이언트 ID 또는 암호를 저장해서는 안 됩니다.
Explorer
API Explorer에서 API를 사용해보고 싶다면 바로 가능합니다. 인증 섹션 표시 버튼을 사용하여 API Explorer UI에서 직접 API 클라이언트 키(client_id)와 암호를 입력할 수 있습니다.
소프트웨어에 API 클라이언트를 포함하는 방법을 알아보려면 API 인증 및 승인을 읽어보세요.