Sandbox 시작하기
샌드박스 모드에 액세스하고 설정하여 안전하게 API 테스트
샌드박스 기능 사용하기
Expedia Group 콘솔에 로그인하고 계정을 선택합니다. 샌드박스 기능에 처음 액세스하면 사용자가 액세스한 파트너 계정을 미러링하는 샌드박스 계정이 생성됩니다.
샌드박스 모드로 전환하는 방법은 두 가지가 있습니다.
1. 글로벌 토글 사용
왼쪽 하단에 있는 계정 이름을 클릭하여 파트너 계정 메뉴로 이동합니다.
계정 플라이아웃에서 샌드박스 모드 토글을 클릭하여 켜기로 설정합니다.
상품 카탈로그로 이동하여 사용해 보고 싶은 상품을 추가합니다. 참고: 샌드박스 모드에서는 샌드박스 지원 상품만 상품 카탈로그에 표시됩니다.
제품이 추가되면 샌드박스별 API 클라이언트를 생성하고 API Explorer, Postman 또는 기타 도구에서 해당 로그인 정보를 사용하여 결과가 예상한 대로인지 확인할 수 있습니다. 샌드박스 모드에서는 생성한 API 로그인 정보가 판매 애플리케이션에 영향을 주지 않으므로, 판매를 시작하기 전에 구성을 세부적으로 조정할 수 있습니다.
라이브 모드로 전환할 준비가 되면 계정 플라이아웃의 토글을 끄기로 다시 전환합니다.
2. 상품 정보 페이지에서 상품 사용해 보기
상품 카탈로그로 이동하여 관심 있는 상품을 찾아봅니다. 샌드박스가 지원되는 상품에는 배지가 표시됩니다.
샌드박스 지원 상품의 상품 카드를 클릭하면 상품 정보 페이지로 연결됩니다. 샌드박스 모드로 전환하려면 페이지 상단의 상품 사용해 보기 버튼을 클릭하세요. Expedia Group 계정에 맞게 샌드박스 계정을 구성하라는 메시지가 표시됩니다.
사용해 볼 제품에 대한 샌드박스별 API 클라이언트를 만들고 API Explorer, Postman 또는 기타 도구에서 로그인 정보를 사용하여 결과가 예상한 대로인지 확인합니다. 샌드박스 모드에서는 생성한 API 로그인 정보가 판매 애플리케이션에 영향을 주지 않으므로, 판매를 시작하기 전에 구성을 세부적으로 조정할 수 있습니다. 참고: 샌드박스 모드에서는 샌드박스 지원 상품만 상품 카탈로그에 표시됩니다.
라이브 모드로 다시 돌아갈 준비가 되면 라이브 모드로 전환 링크를 클릭하거나 계정 플라이아웃으로 돌아가 글로벌 토글을 전환합니다.
샌드박스에서 제품 구성
초기 구성
샌드박스 모드에서 구성을 시작하려면 샌드박스 지원 제품의 제품 정보 페이지에서 제품 사용해 보기를 클릭합니다.
업데이트
- 글로벌 토글을 사용하여 샌드박스 계정을 엽니다.
- 업데이트하려는 제품의 제품 정보 페이지로 이동합니다.
- 상황별 메뉴(오른쪽 상단에 있는 세로 점 세 개)를 열고 구성 업데이트를 선택하여 구성 흐름을 시작합니다.
참고: 이 상황별 메뉴는 실제 계정에서도 사용할 수 있으므로 오류를 방지하려면 샌드박스 계정으로 전환하세요. 샌드박스 선택 항목으로 라이브 구성을 수동으로 업데이트해야 합니다.
API 클라이언트 생성
샌드박스 모드뿐만 아니라 라이브 모드에서 Expedia Group 여행 플랫폼 API를 사용하려면 비밀번호로 보호되는 사용자 계정과 같은 API 클라이언트를 하나 이상 생성해야 합니다. 기본적으로 API 클라이언트는 API 요청을 수행하는 소프트웨어가 사용자의 소유임을 확인하고(인증) 각 클라이언트가 수행할 수 있는 API 요청 유형을 제한할 수 있습니다(승인). API 클라이언트를 생성하는 방법은 두 가지가 있습니다.
- 제품 정보 페이지에서 상황별 메뉴를 클릭하고 API 클라이언트 생성을 선택합니다.
- 왼쪽 내비게이션에서 API 클라이언트 생성을 클릭합니다.
API 클라이언트 생성 페이지에서 사용자 및 조직 내 다른 사용자가 클라이언트에 포함된 제품을 기억하는 데 도움이 되는 이름과 설명을 입력합니다. 사용 가능한 제품 목록에서 포함하려는 범위(API 요청 유형)를 선택합니다. 참고: 최상위 수준의 상자를 선택하면 모든 하위 요소가 선택됩니다.
생성을 클릭합니다.
API 클라이언트가 생성되면 로그인 정보 ID와 암호가 포함된 확인 화면이 표시됩니다. 이 정보는 한 번만 표시됩니다. 로그인 정보와 암호를 복사하여 안전한 위치에 저장해 주세요. GitHub, 클라이언트측 코드 등과 같이 공개적으로 액세스할 수 있는 영역에 클라이언트 ID 또는 암호를 저장해서는 안 됩니다.
제품 및 범위
모든 API 클라이언트는 단일 파트너 계정 내에서 작동합니다. 계정에 제품을 추가하면 API 클라이언트에 포함할 수 있습니다. 단일 API 클라이언트를 생성하고 하나 이상의 제품에 대한 액세스 권한을 부여할 수 있습니다.
각 제품은 특정 요청 유형에 대한 액세스 권한을 부여하는 일련의 범위를 포함합니다. 할당하는 범위는 해당 클라이언트가 수행할 권한이 있는 작업을 제어합니다. 여러 소프트웨어 서비스에서 API 요청을 수행하는 경우 각 서비스에 대해 별도의 API 클라이언트를 생성하고 각 API 클라이언트에 필요한 범위만 선택하는 것이 좋습니다.
샌드박스 API 클라이언트 보기 및 조정
샌드박스 제품에 대한 API 클라이언트를 생성한 후 Developer Hub에서 테스트하려는 제품의 API Explorer 페이지로 이동합니다. 샌드박스를 가리키도록 API 서버 URL을 변경하고 보안 로그인 정보를 연결합니다.
API Explorer, Postman 또는 기타 API 도구를 사용하면 API 클라이언트 설정이 반환하는 결과를 확인할 수 있습니다. 이를 초기에 사용하여 API가 적합한지 확인하고 저희 상품 중 하나를 판매 애플리케이션에 적용하기 전에 설정 변경 사항을 테스트합니다.
라이브로 API 실행
샌드박스 테스트를 완료한 후에는 프로덕션 애플리케이션에서 사용할 API 클라이언트의 라이브 버전을 생성할 수 있습니다.
- 콘솔에 로그인합니다.
- 제품 카탈로그에서 추가하려는 제품의 제품 정보 페이지로 이동합니다.
- 상품 추가를 클릭합니다. 승인이 필요한 상품인 경우 추가 요청을 클릭합니다.
- 상품을 구성합니다. 라이브 설정은 샌드박스 테스트에 사용한 설정의 대다수 또는 대부분을 모방하는 경우가 많습니다.
- 제출을 클릭합니다.
- 라이브 API 클라이언트를 생성합니다. 왼쪽 내비게이션에서 API 클라이언트 생성을 클릭합니다.
- 일반적으로 샌드박스와 동일한 범위를 사용합니다.
- 로그인 정보 가져오기를 클릭합니다.
참고: 제품을 추가하면 Expedia 팀에서 추가 정보를 요청하기 위해 연락드릴 수 있습니다.
샌드박스에서 직접 라이브 환경으로의 실행을 요청할 수도 있습니다. 라이브 모드로 전환 링크를 찾아보세요.
소프트웨어에 API 클라이언트를 포함하는 방법을 알아보려면 API 인증 및 승인을 읽어보세요.