분석 API 시작하기

분석 API를 시작하는 것은 간단합니다. API 키와 공유 암호를 가져오고 테스트를 시작하면 됩니다.

1. 파트너로 등록하기

분석 API와 통합하려면 먼저 화이트 레이블 템플릿 파트너 등록이 필요합니다. 아직 등록하지 않은 경우 Expedia Partner Solutions 사이트에서 등록하실 수 있습니다.

화이트 라벨 템플릿 파트너로 등록하기

2. 옵션 선택하기

파트너로 등록하면 다음과 같은 저희 데이터 도메인 옵션 중에서 선택하실 수 있습니다.

로열티 적립: 고객이 파트너를 통해 여행 상품을 구매하면 포인트가 적립됩니다.
일정: 고객이 파트너 사이트를 통해 예약한 여행 일정을 조정하거나 취소할 수 있도록 지원합니다.

다음으로, API 자격 증명을 받고 인증을 설정합니다. 인증 방법은 통합하려는 제공 메커니즘에 따라 달라집니다.

3. 푸시 방식의 인증 준비하기

알림은 푸시 방식을 통해 제공하시는 엔드포인트로 전송됩니다. 안전하고 신뢰할 수 있는 데이터 전송을 보장하기 위해 각 이벤트에는 API 키와 공유 암호를 사용하여 생성된 헤더 서명이 포함됩니다. 헤더 서명을 통해 Expedia가 발신자임을 인증하고 확인할 수 있습니다.

4. 풀 방식의 인증 구성하기

로열티 적립 및 일정 엔드포인트에 액세스하려면 API 키와 공유 암호가 필요합니다.

4.1 액세스 토큰 요청하기

자격 증명이 통합된 유효한 토큰이 제공됩니다(자세한 내용은 기술 영업 담당자에게 문의). 이 토큰은 HTTP 기본 인증 메커니즘을 사용합니다. base64로 인코딩된 API 키 및 공유 암호 문자열이 포함된 인증 헤더를 제공해야 합니다.

예:

Authorization: Basic {api-key}:{shared-secret}

이 호출은 OpenAPI 사양에 기록된 토큰 엔드포인트를 대상으로 수행됩니다.

securitySchemes:
    oauth:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://analytics.ean.com/template/v1/oauth/token

유효한 인증 호출은 다음 단계에서 사용할 Bearer 토큰을 반환합니다.

4.2 토큰을 사용하여 API에 요청하기

저희는 transactions 또는 last_update 엔드포인트에 Bearer 토큰 인증을 사용합니다. 이전 단계에서 받은 토큰이 포함된 인증 헤더를 제공해야 합니다.

예:

Authorization: Bearer {token}

4.3 요청 테스트하기

자격 증명을 받고 인증을 구성하면 테스트 엔드포인트(https://test.analytics.ean.com/)에 대한 요청 생성하기를 시작할 수 있습니다. 이 엔드포인트를 통해 반환되는 모든 데이터는 샘플 데이터로, 데이터 구조 이해를 돕기 위한 목적으로만 제공됩니다.

중요

모든 파트너에게 안정적이고 유지 관리 가능한 서비스를 제공하기 위해 모든 API 호출에 속도 제한을 적용합니다. 저희 시스템은 비정상적인 API 트래픽을 모니터링하고 시스템 보호를 위한 조치를 자동으로 취합니다. API 호출 동작에 대한 계획된 변경 또는 API에 액세스하여 성능 테스트를 수행하기 전에 담당 분석 API 컨설턴트와 계획을 검토해 주세요.

테스트할 때는 API 버전을 지정해야 합니다. OpenAPI 사양의 servers.url 값을 사용하여 URL을 구성해 주세요. 다음 두 값이 표준값입니다.

통합 검증: test.analytics.ean.com
프로덕션 엔드포인트: analytics.ean.com

참고: 엔드포인트 간에 전환할 때는 프로토콜과 경로 지정(https://[test.]analytics.ean.com)을 유지해야 합니다.

예:

https://test.analytics.ean.com/template/v1/loyalty/earn/last_update
https://test.analytics.ean.com/template/v1/itineraries

servers.url 값은 다운로드 가능한 OpenAPI 사양 파일의 상단에서 확인할 수 있으며, 항상 지정된 API 서비스의 버전 번호와 일치합니다.

예:

openapi: 3.0.1
info:
  title: Analytics API
  description: Analytics API V1
  version: v1

tags:
  - name: Analytics
    description: Template Analytics API

servers:
  - url: https://analytics.ean.com/template/v1
  - url: https://test.analytics.ean.com/template/v1