연동 디렉터리
Amadeus API 연동: 항공 커넥터를 단계별로 설정
Amadeus 모듈은 PHPTRAVELS 항공 검색을 Amadeus Enterprise에 연결합니다. 앱을 등록하고 관리자에 자격 증명 세 개를 붙여 넣은 뒤 개발 모드에서 테스트하고, Amadeus가 계정을 승인하면 운영 환경으로 전환하세요.
- Enterprise 플랜 커넥터
- OAuth2 client credentials
- 개발 및 운영 환경
- 공개된 설정 가이드
커넥터 설정
Amadeus 앱에서 실시간 항공 결과까지 5단계
커넥터는 기성 모듈이므로 표준 설정에는 코드를 작성할 필요가 없습니다. 자체 Amadeus 계정과 상업 조건을 준비하면, 모듈이 PHPTRAVELS 항공 모듈 안에서 인증, 항공편 검색, 주문 생성을 처리합니다.
- Amadeus 모듈이 포함된 Enterprise 플랜으로 시작
- Amadeus for Developers에 가입하고 Flight Offers Search와 Flight Create Orders를 사용하는 앱 생성
- 관리자의 모듈 메뉴에서 grant type, client ID, client secret을 입력하고 Dev mode 켜기
- 사이트에서 항공편을 검색하고 지금 예약 버튼 아래 Amadeus 로고 확인
- 운영 키를 신청해 sandbox 키를 교체하고 Dev mode를 운영으로 전환
- Dev mode
- 개발
- 엔드포인트
- travel.api.amadeus.com/v2/
- c1 · grant_type
- client_credentials
- c2 · client_id
- ••••••••••7Kq2
- c3 · client_secret
- ••••••••••
커넥터의 역할
검색에는 Amadeus 오퍼, 관리자에는 주문
두 개의 Amadeus API가 모듈을 움직입니다. 하나는 결과 페이지로 항공 오퍼를 가져오고, 다른 하나는 여행자가 결제하면 예약을 생성합니다.
- API런던–뉴욕 · 직항일반석 · 8시간 05분 · 위탁 수하물 1개US$486성인 1인당
- v2런던–뉴욕 · 1회 경유일반석 · 11시간 20분 더블린 경유 · 위탁 수하물 1개US$412성인 1인당
- 런던–뉴욕 · 직항비즈니스석 · 7시간 55분 · 위탁 수하물 2개US$2,140성인 1인당
Flight Offers Search와 Flight Create Orders
Offers Search가 결과를 채우고, Create Orders가 선택한 오퍼를 예약으로 바꿉니다. 검색과 예약을 위해 Amadeus 앱에서 둘 다 활성화하세요.
OAuth2 인증
모듈은 관리자에 입력한 client ID와 secret으로 client_credentials grant를 사용해 액세스 토큰을 요청합니다.
개발 및 운영 모드
Dev mode 설정 하나로 요청이 sandbox 키를 쓸지 승인된 운영 키를 쓸지 결정됩니다.
Enterprise 엔드포인트
모듈은 travel.api.amadeus.com/v2/를 기반으로 합니다. 일부 지역은 다른 엔드포인트를 쓰므로 키를 입력하기 전에 확인하세요.
모든 결과에 출처 표시
지금 예약 버튼 아래의 Amadeus 로고로 어떤 요금이 Amadeus에서 왔는지 보여 주어 연결을 한눈에 확인할 수 있습니다.
알려진 오류 원인
대부분은 잘못된 자격 증명, 키와 맞지 않는 모드, 또는 Amadeus 대시보드에서 비활성화된 API 서비스 때문입니다.
요청 흐름
Amadeus 검색마다 일어나는 일
개발과 운영 환경에서 같은 순서가 실행되며, 바뀌는 것은 키와 Dev mode 설정뿐입니다.
인증
client ID와 secret을 액세스 토큰으로 교환합니다.
검색
Flight Offers Search가 노선, 날짜, 승객 기준 요금을 반환합니다.
표시
오퍼는 마크업이 적용된 채 다른 연결된 공급사 결과 옆에 표시됩니다.
주문
Flight Create Orders가 여행자 정보로 선택한 오퍼를 예약합니다.
기록
예약이 관리자에 저장되고 확인 메일이 발송됩니다.
Amadeus의 위치
자체 Amadeus 계정, 다른 항공 API, 맞춤 개발
Amadeus 모듈은 여러 항공 커넥터 중 하나이며, 각각 고유한 자격 증명으로 같은 검색 안에서 작동합니다.
자체 Amadeus Enterprise 계정
Amadeus는 사용 사례, 사업자 등록, 웹사이트를 검토한 뒤 운영 키를 발급하고, 고객은 상업 조건에 동의합니다.
다른 항공 커넥터
연동 디렉터리에서 Duffel, Kiwi 등 항공 공급사를 추가하고 하나의 결과 목록에서 요금을 비교하세요.
다른 엔드포인트와 API
지역별 Amadeus 엔드포인트나 모듈이 아직 사용하지 않는 API는 맞춤 개발로 추가할 수 있습니다.
연결할 수 있는 항공 공급사:
Seeru
Amadeus
Duffel
Google Flights
Kayak
Kiwi
Mystifly
PKfare
Sabre
TBO Holidays
Travelport
백오피스
같은 관리자에서 Amadeus 예약 운영
키를 입력하면 Amadeus 요금도 다른 항공 공급사에 적용하던 규칙을 그대로 따릅니다.
항공 마크업
고정 금액 또는 비율 마크업으로 Amadeus 요금에 판매가를 표시합니다.
예약 목록
Amadeus 예약은 여행자 정보와 상태와 함께 항공 예약 화면에 표시됩니다.
B2B 에이전트
에이전트는 에이전트 포털에서 자신의 요율로 Amadeus 요금을 검색하고 예약합니다.
결제
여행자는 활성화한 결제 게이트웨이로, 에이전트는 지갑에서 결제합니다.
키는 자체 서버에
자격 증명은 공유 플랫폼이 아닌 자체 호스팅 관리자에 저장됩니다.
지원 티켓
연결이나 예약에 도움이 필요하면 app.phptravels.com에서 티켓을 여세요.
비교
Amadeus 직접 개발 vs PHPTRAVELS 모듈
둘 다 같은 Amadeus 계정을 씁니다. 차이는 팀이 그 주변을 얼마나 작성하고 유지하느냐입니다.
| 작업 | API 직접 개발 | PHPTRAVELS |
|---|---|---|
| 인증 | API 직접 개발토큰 요청과 갱신을 개발자가 직접 작성 | PHPTRAVELS관리자 필드 세 개로 모듈이 처리 |
| 검색 결과 | API 직접 개발오퍼 데이터를 자체 결과 페이지에 매핑 | PHPTRAVELS기존 항공 검색에 오퍼 표시 |
| 예약 | API 직접 개발여행자 양식과 주문 호출을 처음부터 구축 | PHPTRAVELSCreate Orders가 체크아웃과 결제에 연결됨 |
| 테스트와 운영 | API 직접 개발환경마다 별도 구성 | PHPTRAVELSDev mode 스위치 하나 |
| 마크업과 예약 | API 직접 개발설계하고 구축해야 하는 백오피스 | PHPTRAVELS항공 관리자에 포함 |
| 설정 단계 | API 직접 개발팀이 작성하고 최신 상태로 유지 | PHPTRAVELSdocs.phptravels.com에 공개된 가이드 |
활용 사례
Amadeus 모듈을 켜는 곳
온라인 여행사
Amadeus 콘텐츠 기반 공개 항공 검색, 자체 마크업과 체크아웃 적용.
B2B 에이전트 네트워크
하위 에이전트가 포털에서 귀사의 요율로 Amadeus 요금을 예약합니다.
출장 관리 회사
기업 예약 담당자가 귀사가 호스팅하고 관리하는 플랫폼에서 Amadeus 요금을 검색합니다.
PHPTRAVELS를 선택하는 이유
읽고, 바꾸고, 직접 호스팅할 수 있는 커넥터
소스 코드 포함
상업 라이선스로 자체 호스팅하므로 개발자가 Amadeus 모듈을 확장할 수 있습니다.
문서화된 설정
모든 단계, 필드, 오류 원인이 docs.phptravels.com에 정리되어 있습니다.
24개 언어
오른쪽에서 왼쪽으로 쓰는 언어를 포함해 시장별 언어로 Amadeus 요금을 표시합니다.
B2C와 B2B
공개 사이트와 에이전트 포털을 하나의 설치로.
기성 항공 모듈입니다. Amadeus for Developers에서 앱을 만들고 그 자격 증명을 관리자에 입력하면 Amadeus 오퍼가 항공 검색에 나타나고, 예약은 Flight Create Orders로 생성됩니다.
Amadeus 모듈은 Enterprise 플랜에서 제공되며, 가격 페이지에 표시된 대로 일회성 $9999입니다. Amadeus 계정과 상업 조건은 별도이며 Amadeus와 협의합니다.
client_credentials grant type, client ID, client secret입니다. 앱을 만들면 Amadeus가 sandbox 키를 발급하고, 운영 신청이 승인되면 운영 키를 발급합니다.
모듈은 travel.api.amadeus.com/v2/를 사용합니다. 일부 지역은 엔드포인트나 매개변수가 다르므로 먼저 계정을 확인하세요. 다른 엔드포인트는 맞춤 개발로 추가할 수 있습니다.
Amadeus 앱에서 활성화한 API에 따라 둘 다 가능합니다. Flight Offers Search가 결과를 제공하고, 예약하려면 Flight Create Orders를 활성화해야 합니다.
문서화된 커넥터는 항공용입니다. Amadeus는 숙박 공급사로도 등록되어 있지만 설정 가이드가 아직 공개되지 않았으니 호텔 범위는 저희 팀에 문의하세요.