샌드박스 모드

샌드박스 기능으로 안전하게 API 테스트

무료 샌드박스 기능을 사용하면 Expedia API 제품을 테스트할 수 있습니다. 샌드박스 모드에서 수행하는 작업은 프로덕션 애플리케이션에 반영되지 않으며, 그 반대의 경우도 마찬가지입니다.

샌드박스 기능을 사용하면 다음을 수행할 수 있습니다.

• 안전하고 위험 없는 방식으로 샌드박스 지원 제품을 사용해 볼 수 있습니다.
• 샌드박스별 API 클라이언트를 만들 수 있습니다.
• 필요에 따라 샌드박스 제품 구성을 업데이트할 수 있습니다.
• API Explorer, Postman 또는 기타 도구를 사용하여 샌드박스 엔드포인트를 테스트할 수 있습니다.

샌드박스 모드에 액세스하기

Expedia Group 콘솔에 로그인하고 계정을 선택합니다. 샌드박스 기능에 처음 액세스하면 사용자가 액세스한 파트너 계정을 미러링하는 샌드박스 계정이 생성됩니다.

샌드박스 모드로 전환하는 방법은 두 가지가 있습니다.

1. 글로벌 토글 사용

왼쪽 하단에 있는 계정 이름을 클릭하여 파트너 계정 메뉴로 이동합니다.

계정 플라이아웃에서 샌드박스 모드 토글을 클릭하여 켭니다.

샌드박스 모드에서는 프로덕션 애플리케이션에 영향을 주지 않고 변경할 수 있습니다. 제품 카탈로그에는 샌드박스 지원 제품만 표시됩니다.

라이브 모드로 전환할 준비가 되면 계정 플라이아웃의 토글을 끄기로 다시 전환합니다.

2. 제품 정보 페이지에서 제품 사용해 보기

제품 카탈로그로 이동하여 관심 있는 제품을 찾아봅니다. 샌드박스가 지원되는 제품에는 배지가 표시됩니다.

샌드박스 지원 제품의 제품 카드를 클릭하면 제품 정보 페이지로 연결됩니다. 샌드박스 모드로 전환하려면 페이지 상단의 제품 사용해 보기 버튼을 클릭하고 테스트 구성을 진행합니다.

라이브 모드로 다시 돌아갈 준비가 되면 라이브 모드로 전환 링크를 클릭하거나 계정 플라이아웃으로 돌아가 글로벌 토글을 전환합니다.

샌드박스에서 제품 구성

초기 구성

샌드박스 모드에서 구성을 시작하려면 샌드박스 지원 제품의 제품 정보 페이지에서 제품 사용해 보기를 클릭합니다.

업데이트

1. 글로벌 토글을 사용하여 샌드박스 계정을 엽니다.
2. 업데이트하려는 제품의 제품 정보 페이지로 이동합니다.
3. 상황별 메뉴(오른쪽 상단에 있는 세로 점 세 개)를 열고 구성 업데이트를 선택하여 구성 흐름을 시작합니다.

참고: 이 상황별 메뉴는 실제 계정에서도 사용할 수 있으므로 오류를 방지하려면 샌드박스 계정으로 전환하세요. 샌드박스 선택 항목으로 라이브 구성을 수동으로 업데이트해야 합니다.

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 실행

샌드박스 테스트를 완료한 후에는 프로덕션 애플리케이션에서 사용할 API 클라이언트의 라이브 버전을 생성할 수 있습니다.

1. 콘솔에 로그인합니다.
2. 제품 카탈로그에서 추가하려는 제품의 제품 정보 페이지로 이동합니다.
3. 제품 추가를 클릭합니다. 승인이 필요한 제품인 경우 추가 요청을 클릭합니다.
4. 샌드박스에서와 동일하게 제품을 구성합니다.
5. 제출을 클릭합니다.
6. 라이브 API 클라이언트를 생성합니다. 왼쪽 내비게이션에서 API 클라이언트 생성을 클릭합니다.
7. 일반적으로 샌드박스와 동일한 범위를 사용합니다.
8. 로그인 정보 가져오기를 클릭합니다.

참고: 제품을 추가하면 Expedia 팀에서 추가 정보를 요청하기 위해 연락드릴 수 있습니다.

샌드박스에서 직접 라이브 환경으로의 실행을 요청할 수도 있습니다. 라이브 모드로 전환 링크를 찾아보세요.

소프트웨어에 API 클라이언트를 포함하는 방법을 알아보려면 API 인증 및 승인을 읽어보세요.