Danh mục tích hợp
Tích hợp API Amadeus: connector vé máy bay, cài đặt từng bước
Module Amadeus kết nối tìm kiếm chuyến bay của PHPTRAVELS với Amadeus Enterprise. Đăng ký một ứng dụng, dán ba thông tin xác thực vào admin, thử ở chế độ phát triển và chuyển sang production khi Amadeus duyệt tài khoản của bạn.
- Connector gói Enterprise
- OAuth2 client credentials
- Phát triển và production
- Hướng dẫn cài đặt đã xuất bản
Cài đặt connector
Từ ứng dụng Amadeus đến kết quả chuyến bay trực tiếp trong năm bước
Connector là một module có sẵn, nên cài đặt tiêu chuẩn không cần viết mã. Bạn dùng tài khoản Amadeus và điều khoản thương mại của riêng mình, còn module xử lý xác thực, tìm chuyến bay và tạo đơn ngay trong module vé máy bay của PHPTRAVELS.
- Bắt đầu với gói Enterprise, gói có kèm module Amadeus
- Đăng ký Amadeus for Developers và tạo ứng dụng với Flight Offers Search và Flight Create Orders
- Nhập grant type, client ID và client secret trong mục Module của admin, bật Dev mode
- Tìm chuyến bay trên website và kiểm tra logo Amadeus dưới nút Đặt ngay
- Xin khóa production, thay khóa sandbox và chuyển Dev mode sang production
- Dev mode
- Phát triển
- Endpoint
- travel.api.amadeus.com/v2/
- c1 · grant_type
- client_credentials
- c2 · client_id
- ••••••••••7Kq2
- c3 · client_secret
- ••••••••••
Connector làm gì
Ưu đãi Amadeus trong tìm kiếm, đơn hàng trong admin
Hai API Amadeus vận hành module: một API trả ưu đãi chuyến bay về trang kết quả, API còn lại tạo đặt chỗ khi khách thanh toán.
- APILondon đến New York · Bay thẳngPhổ thông · 8 giờ 05 phút · 1 kiện ký gửi486 US$mỗi người lớn
- v2London đến New York · 1 điểm dừngPhổ thông · 11 giờ 20 phút qua Dublin · 1 kiện ký gửi412 US$mỗi người lớn
- London đến New York · Bay thẳngThương gia · 7 giờ 55 phút · 2 kiện ký gửi2.140 US$mỗi người lớn
Flight Offers Search và Flight Create Orders
Offers Search đổ dữ liệu vào kết quả; Create Orders biến ưu đãi được chọn thành đặt chỗ. Bật cả hai trong ứng dụng Amadeus để tìm và đặt.
Xác thực OAuth2
Module yêu cầu access token bằng grant client_credentials, dùng client ID và secret bạn nhập trong admin.
Chế độ phát triển và production
Một thiết lập Dev mode quyết định yêu cầu dùng khóa sandbox hay khóa production đã được duyệt.
Endpoint Enterprise
Module được xây trên travel.api.amadeus.com/v2/. Một số khu vực dùng endpoint khác, nên hãy xác nhận endpoint của bạn trước khi nhập khóa.
Hiện nguồn trên mỗi kết quả
Logo Amadeus dưới nút Đặt ngay cho biết giá vé nào đến từ Amadeus, giúp kiểm tra kết nối chỉ trong một cái nhìn.
Nguyên nhân lỗi thường gặp
Phần lớn lỗi do sai thông tin xác thực, chế độ không khớp với khóa, hoặc dịch vụ API chưa bật trong bảng điều khiển Amadeus.
Luồng yêu cầu
Điều gì xảy ra trong mỗi lượt tìm Amadeus
Cùng một trình tự chạy ở phát triển và production; chỉ khóa và thiết lập Dev mode thay đổi.
Xác thực
Client ID và secret được đổi lấy access token.
Tìm kiếm
Flight Offers Search trả giá vé theo hành trình, ngày và hành khách.
Hiển thị
Ưu đãi hiện kèm phần markup của bạn, cạnh kết quả từ các nhà cung cấp khác đã kết nối.
Đặt đơn
Flight Create Orders đặt ưu đãi được chọn với thông tin hành khách.
Lưu
Đặt chỗ được lưu trong admin và xác nhận được gửi qua email.
Vị trí của Amadeus
Tài khoản Amadeus của bạn, API vé máy bay khác và phát triển riêng
Module Amadeus là một trong nhiều connector vé máy bay, mỗi connector chạy bằng thông tin xác thực riêng trong cùng một lượt tìm.
Tài khoản Amadeus Enterprise của bạn
Amadeus cấp khóa production sau khi xem xét mục đích sử dụng, đăng ký doanh nghiệp và website của bạn, và bạn chấp nhận điều khoản thương mại.
Connector vé máy bay khác
Thêm Duffel, Kiwi hoặc nhà cung cấp vé máy bay khác từ danh mục tích hợp và so sánh giá trong một danh sách kết quả.
Endpoint và API khác
Endpoint Amadeus theo khu vực hoặc API mà module chưa dùng có thể được thêm dưới dạng phát triển riêng.
Nhà cung cấp vé máy bay bạn có thể kết nối:
Seeru
Amadeus
Duffel
Google Flights
Kayak
Kiwi
Mystifly
PKfare
Sabre
TBO Holidays
Travelport
Back office
Quản lý đặt chỗ Amadeus trong cùng admin
Khi đã nhập khóa, giá vé Amadeus tuân theo các quy tắc bạn đang dùng cho mọi nhà cung cấp vé máy bay khác.
Markup vé máy bay
Thêm markup cố định hoặc theo phần trăm để giá Amadeus hiển thị giá bán của bạn.
Danh sách đặt chỗ
Đặt chỗ Amadeus nằm cùng thông tin hành khách và trạng thái trong màn hình đặt vé máy bay.
Đại lý B2B
Đại lý tìm và đặt giá Amadeus trong cổng đại lý với mức giá riêng.
Thanh toán
Khách trả qua các cổng thanh toán bạn đã bật, đại lý trả từ ví.
Khóa trên máy chủ của bạn
Thông tin xác thực được lưu trong admin tự lưu trữ của bạn, không phải trên nền tảng dùng chung.
Phiếu hỗ trợ
Mở phiếu tại app.phptravels.com nếu kết nối hoặc đặt chỗ cần chúng tôi hỗ trợ.
So sánh
Tự lập trình với Amadeus và module PHPTRAVELS
Cả hai dùng cùng tài khoản Amadeus. Khác biệt là đội của bạn phải viết và duy trì bao nhiêu thứ xung quanh.
| Công việc | Tự tích hợp API | PHPTRAVELS |
|---|---|---|
| Xác thực | Tự tích hợp APILập trình viên tự viết yêu cầu và gia hạn token | PHPTRAVELSModule xử lý từ ba trường trong admin |
| Kết quả tìm kiếm | Tự tích hợp APIÁnh xạ dữ liệu ưu đãi vào trang kết quả riêng | PHPTRAVELSƯu đãi hiện trong tìm kiếm chuyến bay sẵn có |
| Đặt chỗ | Tự tích hợp APIBiểu mẫu hành khách và lệnh đặt đơn làm từ đầu | PHPTRAVELSCreate Orders đã nối với checkout và thanh toán |
| Thử và chạy thật | Tự tích hợp APICấu hình riêng cho từng môi trường | PHPTRAVELSMột công tắc Dev mode |
| Markup và đặt chỗ | Tự tích hợp APIMột back office cần thiết kế và xây dựng | PHPTRAVELSCó sẵn trong admin vé máy bay |
| Các bước cài đặt | Tự tích hợp APIĐội của bạn tự viết và cập nhật | PHPTRAVELSHướng dẫn trên docs.phptravels.com |
Trường hợp sử dụng
Ai bật module Amadeus
Đại lý du lịch trực tuyến
Tìm chuyến bay công khai trên nội dung Amadeus, với markup và checkout của bạn.
Mạng lưới đại lý B2B
Đại lý cấp dưới đặt giá Amadeus qua cổng của bạn theo mức giá của bạn.
Công ty quản lý công tác
Người đặt vé doanh nghiệp tìm giá Amadeus trên nền tảng bạn lưu trữ và kiểm soát.
Vì sao chọn PHPTRAVELS
Connector bạn có thể đọc, sửa và tự lưu trữ
Kèm mã nguồn
Tự lưu trữ theo giấy phép thương mại, để lập trình viên mở rộng module Amadeus.
Cài đặt có tài liệu
Mọi bước, trường và nguyên nhân lỗi đều được viết trên docs.phptravels.com.
24 ngôn ngữ
Hiển thị giá Amadeus bằng ngôn ngữ của thị trường bạn, kể cả viết từ phải sang trái.
B2C và B2B
Một bản cài đặt cho website công khai và cổng đại lý.
Câu hỏi thường gặp
Câu hỏi về connector Amadeus
Những điều các đội hỏi khi cài đặt module Amadeus.
Liên hệ kinh doanhĐây là module vé máy bay có sẵn. Bạn tạo ứng dụng trên Amadeus for Developers, nhập thông tin xác thực vào admin, và ưu đãi Amadeus xuất hiện trong tìm kiếm chuyến bay, đặt chỗ được tạo qua Flight Create Orders.
Module Amadeus có trong gói Enterprise, thanh toán một lần $9999 theo trang bảng giá. Tài khoản Amadeus và điều khoản thương mại của nó là riêng và được thỏa thuận với Amadeus.
Grant type client_credentials, một client ID và một client secret. Amadeus cấp khóa sandbox khi bạn tạo ứng dụng và khóa production sau khi duyệt yêu cầu production.
Module dùng travel.api.amadeus.com/v2/. Một số khu vực có endpoint hoặc tham số khác, nên hãy kiểm tra tài khoản trước; endpoint khác có thể được thêm dưới dạng phát triển riêng.
Cả hai, tùy API đã bật trong ứng dụng Amadeus. Flight Offers Search cho kết quả, còn Flight Create Orders phải được bật để đặt chỗ.
Connector có tài liệu là dành cho vé máy bay. Amadeus cũng được liệt kê là nhà cung cấp lưu trú, nhưng hướng dẫn cài đặt chưa được xuất bản, vì vậy hãy hỏi đội ngũ của chúng tôi về phạm vi khách sạn.
Khám phá thêm