サプライヤーとサービスのAPIハブ

ひとつの予約プラットフォームにつながる旅行API

このサイトの旅行APIガイドをすべて一か所に:GDSと航空会社のコンテンツ、ホテルのベッドバンクとエクストラネット、ツアー、レンタカーと送迎、決済ゲートウェイとバックオフィスツール。ディレクトリをカテゴリで絞り込み、在庫を調達する三つの方法を比較し、連携がサンドボックスキーから本番販売に至るまでの道のりをたどれます。

  • カテゴリ別の連携ガイド
  • 検索・価格・予約・発券の流れ
  • API・予約エンジン・GDSの比較
  • ソースコード付きのセルフホスト

要点

旅行APIとは何か、どこに位置づくのか

このハブのどのページにも三つの用語が登場します。サプライヤーを選ぶ前に、それぞれの意味を確認しておきましょう。

初めての方はAPI連携とはから始め、次に旅行API連携の技術解説をお読みください。すぐに使えるコネクタの一覧はすべての連携にあり、それらを利用する予約モジュールはプラットフォーム概要で説明しています。

  • 旅行API

    航空券、ホテル、レンタカー、ツアーの空席・空室、運賃、規則、コンテンツといった検索可能な旅行データを、通常JSONまたはXMLで返すプログラム向けのエンドポイントです。

  • 旅行API連携

    サプライヤー、GDS、アグリゲーターのエンドポイントを予約エンジンにつなぐ作業です。認証、フィールドのマッピング、冪等な予約呼び出し、エラーと再試行のポリシーが含まれます。

  • セルフホストのコネクタ

    PHPTRAVELSはライセンスとともにコネクタのコードを提供するため、各サプライヤーと通信するアダプタを御社のチームが読み、拡張し、ホストできます。

すべてのサプライヤーに共通する呼び出しの順序

  1. 01検索
  2. 02価格確認と再検証
  3. 03予約
  4. 04発券または確定

サプライヤー名や応答の形式は異なりますが、下のディレクトリにあるどのコネクタも、この同じ四段階の呼び出しに対応しています。

ディレクトリ

カテゴリ別の旅行API

カテゴリを選ぶと一覧が絞り込まれます。各項目から、そのサプライヤーやサービスが返す内容とプラットフォームでの設定方法をまとめた専用ガイドが開きます。

GDS・航空会社・航空券API

20 件のガイド

航空券モジュール向けのグローバル流通システム、NDC、LCCアグリゲーター、コンソリデーター、フライトデータサービス。

ホテルAPI・ベッドバンク・エクストラネット

15 件のガイド

ホテル検索に客室と料金を供給する卸売ベッドバンク、OTAアフィリエイトプログラム、エクストラネット、チャネルマネージャー。

在庫を調達する三つの方法

旅行API・予約エンジン・GDS APIの比較

直接のAPI、パッケージ化された予約エンジン、生のGDS契約を同じ買い物のように比べるチームは少なくありません。それぞれ解決する課題が異なり、通常は組み合わせて使います。

基準旅行API予約エンジンGDS API
目的旅行APIエンドポイント経由のデータと操作予約エンジンフロントエンド、ビジネスルール、決済GDS API従来チャネルとNDCによる航空コンテンツと付帯サービス
コンテンツの範囲旅行APIホテル、航空券、レンタカー、アクティビティ、ベッドバンク予約エンジン接続したすべてについて検索から決済までGDS API主に航空会社とその付帯サービス
連携の工数旅行API中:フィールドのマッピング、冪等性、再試行予約エンジンゼロから構築すると中〜高、PHPTRAVELSでは低GDS API高:PCC設定、キュー、認証、監査
商条件旅行API呼び出し単位、マークアップ、座席単位でサプライヤーが設定予約エンジンPHPTRAVELSの一回払いライセンスとゲートウェイ手数料GDS APIGDS契約、インセンティブ、セグメント目標
向いている事業旅行API複数サプライヤーを組み合わせるOTAとDMC予約エンジン自社ブランドと自社ルールでの直接販売GDS API航空中心の代理店と出張管理会社
市場投入までの時間旅行API認証情報が発行されれば早い予約エンジンインストール、サプライヤー接続、ブランド設定、公開GDS API承認と認証が先に必要なため最も長い

PHPTRAVELSは予約エンジンの列にあたります。サプライヤーAPIやGDS契約はここに接続するため、ソフトウェアを一度購入し、契約が整うたびにフィードを追加できます。価格は料金、ホスティング面は動作要件をご覧ください。

キーの受領から本番販売まで

API連携が本番稼働するまでの流れ

下のレールはディレクトリにあるどのサプライヤーにも共通する作業順序で、コネクタを有効にしたあとプラットフォームがやり取りするリクエストとレスポンスを添えています。

  1. 01

    認証情報

    サプライヤー契約に署名し、サンドボックスキー、エンドポイント、ドキュメント一式を受け取ります。

  2. 02

    サンドボックス接続

    管理画面にキーを入力し、最初の検索を実行して、コネクタが応答を読めることを確認します。

  3. 03

    コンテンツのマッピング

    サプライヤーのコードをプラットフォームのマスターデータに対応づけます:空港、ホテルID、食事条件、車両クラス。

  4. 04

    マークアップとルール

    代理店ごと、B2Bエージェントごと、顧客グループごとにマークアップ、税金、手数料、通貨ルールを設定します。

  5. 05

    テスト予約

    サプライヤーの認証シナリオを完了します:予約、変更、キャンセル、そしてテストコンソールとの照合。

  6. 06

    本番キー

    本番の認証情報に切り替え、公開サイトとB2Bポータルでサプライヤーを有効にし、最初の予約を監視します。

プラットフォームが送信する再検証呼び出しの例

>リクエストPOST /api/v1/hotels/price
{  "supplier": "hotelbeds",1  "env": "production",1  "rateKey": "HB-20261112-118742-DBL-BB",  "occupancy": { "rooms": 1, "adults": 2 },  "currency": "USD",  "markupRule": "b2c-default"2}
<レスポンス200 OK
{  "status": "available",  "net": 184.00,2  "sell": 206.08,2  "currency": "USD",  "cancellation": { "deadline": "2026-11-09", "fee": 184.00 },  "hold": "PT-HLD-7731",3  "expiresIn": 9003}
  1. 1

    サプライヤーのキーは環境ごとに保存され、顧客に届くリクエスト本文には決して含まれません。

  2. 2

    仕入価格と販売価格は一緒に送られ、マークアップルール名がバックオフィスに差額の理由を伝えます。

  3. 3

    ホールド参照により、顧客が支払いを再試行しても予約呼び出しは冪等に保たれます。

  4. 連携の解説を見る

ビジネスモデルで選ぶ

事業の種類ごとに最初につなぐ旅行API

ディレクトリが長いのは、旅行事業がそれぞれ違うからです。オンボーディングでよく見かける最初の組み合わせを示します。

  • 01

    オンライン旅行代理店

    航空券用のGDSまたはNDCフィード、ホテル用のベッドバンク一〜二社、レンタカーブローカー、カード決済ゲートウェイ。まず幅を広げ、その後に直接契約へ。

  • 02

    デスティネーション管理会社

    管理画面に登録した自社在庫、穴を埋めるベッドバンク、ツアー市場と送迎。航空券は後からコンソリデーター経由で追加されることが多いです。

  • 03

    出張管理

    交渉運賃付きのGDSコンテンツ、エクストラネットまたはベッドバンク経由のホテルプログラム、承認ルール、会計エクスポート。

  • 04

    コンソリデーターまたはB2B卸売

    サブエージェントごとのマークアップを備えた複数の航空ソース、エージェントウォレット、銀行振込とゲートウェイ決済、会計フィード。

各モデルは専用ページで説明しています:オンライン旅行会社、DMC、出張管理。卸売事業者のサブエージェント与信はエージェントウォレットで、これらのフィードをパートナーに配信するホワイトラベル層はホワイトラベルB2Bポータルで解説しています。

よくある質問

旅行APIについての回答

サプライヤー選定の前に購入者から寄せられる質問への短い回答です。

営業に相談

旅行APIは、サプライヤー、GDS、アグリゲーターがリアルタイム在庫、価格、規則、そして検索・再検証・予約・キャンセルといった操作を公開するエンドポイントです。予約プラットフォームがこれを呼び出し、応答を検索結果、カート、確定した予約に変換します。

サプライヤーのキーによる認証、そのコードと御社マスターデータのマッピング、検索・価格・予約の順次呼び出し、重複予約を起こさないエラーと再試行の処理、結果の決済・バウチャー・会計への引き渡しです。PHPTRAVELSではコネクタがすでにこれを実装しており、御社の作業は認証情報、マッピング、ルールの設定になります。

はい。プラットフォームはセルフホストで、ソースコードは商用ライセンスのもとで同梱されます。開発者は各アダプタを読み、ディレクトリにないサプライヤーを追加し、既存コネクタのコンテンツマッピングを変更できます。

単一のフィードよりも組み合わせが一般的です。幅を出すLCCアグリゲーター、フルサービス航空会社と発券のためのNDCまたはGDSコンテンツ、自社の航空契約がない場合のコンソリデーターです。ディレクトリの航空券グループに各選択肢のガイドがあります。

モジュールごとに複数です。プラットフォームは有効な各サプライヤーに問い合わせ、マスターIDで結果を統合し、重複を除き、価格表示の前にマークアップルールを適用します。二つ目のベッドバンクや航空ソースの追加は再構築ではなく設定変更です。

API自体はサプライヤーが価格を決め、通常は呼び出し単位、予約単位、またはマークアップ契約で課金されます。アフィリエイトプログラムで無料のものもあります。これらをつなぐPHPTRAVELSのソフトウェアは、料金ページに記載のとおり2,499ドルからの一回払いライセンスです。