本文へスキップ
ブログ

ドバイでAPI連携会社に依頼する前に決めること

Tekravel 編集部
AI の支援を受けて執筆

机の上に見積書が三通あります。どの連携会社にも旅行サイトの実績があり、どこも「航空APIをあなたのサイトにつなぎます」と約束し、いちばん安いところは来週から着手できると言っています。あなたはデイラで社員六人、安定した法人顧客を持つ旅行会社を経営していて、仕入先のエクストラネットから運賃をWhatsAppのメッセージに打ち直す作業にうんざりしています。いちばん有能に見えるドバイのAPI連携会社を選ぶことが、決定のすべてに思えます。

実際には三分の一ほどです。サイトが売れるかどうかを決める判断は、三通のどの見積書にも載っていません。コードではないからです。仕入先と契約しているのは誰か、航空券は誰の名義で発券されるのか、予約から発券までのあいだお金はどこにあるのか、顧客がキャンセルしたとき返金を処理するのは誰か。連携会社はこれらをすべてつなぎ合わせることはできます。けれども、あなたの代わりにそのどれかになることはできません。

この文章は作業範囲書を読む開発者ではなく、それに署名する経営者のために書いています。

ドバイのAPI連携会社にできること、できないこと

連携会社が書くのは、仕入先のAPIとあなたのサイトのあいだのコードです。検索フォーム、空席や空室を問い合わせる呼び出し、決済前の価格再確認、予約リクエスト、結果を表示する画面、そして範囲に入っていれば取消と返金の呼び出し。良い会社は地味でも大事な部分も押さえます。仕入先が応答しないときの再試行、失敗した予約をたどれるログ、本番と同じように動くテスト環境です。

彼らが渡せないのは、そのコードの向こう側にあるものすべてです。一行目が書かれる前に、旅行会社には次のものが必要です。

  • 旅行会社自身の名義の仕入先アカウントと、そのアカウントに付与されたAPIアクセス;
  • 発券権限:自社の認可か、代わりに発券してくれるconsolidator;
  • その仕入先との資金の取り決め:デポジット、与信枠、またはカード決済の受け渡し;
  • 発券後の作業(void、払い戻し、再発行、スケジュール変更)をAPIで、それが無理なら手作業で引き受ける人。

「仕入先側はこちらで何とかします」と言う連携会社は、たいてい自分のアカウントを貸すと言っています。試作品の近道としてなら妥当なこともあります。しかし事業としては、あなたの予約サイトが、あなたの持っていない、そして持ち出すこともできない関係の上で動くということです。

要件書:作業範囲書に入れる七つの項目

連携会社との揉め事の多くは、誰も書き留めなかった一文にさかのぼります。署名する書類にこれらを平易な言葉で入れ、それぞれの回答を書面でもらってください。

  1. 仕入先アカウントとAPIキーは誰の名義か。旅行会社の名義です。キーは認証情報です。あなたのパスワード保管庫に置き、連携会社には所有権ではなくアクセス権を与えます。
  2. サイトをホストするのは誰か、ドメインを持つのは誰か。ドメインは旅行会社の名義で登録します。ホスティングのアカウントも旅行会社のものにするか、どう移管するかを契約に正確に書きます。
  3. どの機能が範囲に入るか。名前で列挙してください:検索、価格確認、予約、発券、取消、払い戻し、変更。リストにないものは、サイトが動いているあいだずっと仕入先デスクへのメールのままです。払い戻しと変更がいちばん抜けやすい。デモでは決して見せない機能だからです。
  4. 仕入先がAPIを変えたら誰が保守するか。仕入先はバージョンを廃止し、項目名を変えます。保守条項のない固定価格の開発は、最初のバージョンが変わった日に終わります。
  5. 引き渡しとは何を意味するか。旅行会社が所有するリポジトリにあるソースコード、すべての認証情報、そして別の開発者が引き継げる文書。「zipで送ります」は引き渡しではありません。
  6. 本番開始をどう証明するか。実際の顧客のカードを預かる前に、仕入先のテスト環境で検索から発券まで、取消も含めたテスト予約を一件。
  7. 顧客データはどう扱われるか。旅客の氏名、旅券情報、決済の参照番号。どこに保存され、誰が読めて、どう削除されるのか。

どれも技術の知識がなくても書けます。そしてどれも、開発後に交渉するより開発前に合意するほうが安く済みます。

仕入先のコンテンツをサイトに載せる三つの方法

仕入先のAPIに対して連携会社を雇うのは一つの道です。見積書に選択を決められてしまう前に、ほかの二つの道と並べて見ておく価値があります。

方法仕入先との関係を持つのは接続を動かし続けるのは旅行会社がなお作るもの離れるときのコスト
連携会社があなたのサイトを仕入先のAPIにつなぐ要件書に書けば旅行会社、書かなければ連携会社であることが多い保守契約を結んだ連携会社、または誰も管理画面、マークアップ、顧客記録、レポート、決済、アフター対応の画面コードとキーが自分のものなら小さい、そうでなければ作り直し
連携会社があなたのサイトをプラットフォームのAPIにつなぐ仕入先との契約はプラットフォーム、プラットフォームのアカウントは旅行会社仕入先側はプラットフォーム、あなたの側は連携会社あなたのサイトと、プラットフォームのAPIが扱わない部分別のAPIに合わせてあなたの側を書き直す
すでに接続済みのホワイトラベル店舗旅行会社のアカウントを通じてプラットフォームプラットフォームコンテンツ、価格の判断、自社の顧客ドメインと顧客リストを別の事業者へ移す

議論する価値があるのは一行目です。いちばん自由がきき、いちばん多くをあなたに背負わせます。仕入先の変更も、新しいサービスも、最初の開発で漏れた機能も、そのたびに別の見積もりの別のプロジェクトになります。

すでに運営しているサイトに検索を載せる方法は既存サイトに航空券検索を追加するで、その裏に誰のAPIを置くかは航空券予約APIプロバイダーの選び方で論じました。この記事は、その作業を取り巻く契約の話です。

このプラットフォームの位置づけ

このブログの背後にあるプラットフォームは、航空とホテルのAPIを提供しています。アクセスはセルフサービスのキーではなく、相談から始まります。最初の質問が、どのエンドポイントを呼ぶかではなく上に挙げたこと、つまりどのサービスを、どの市場で、お金がどう動くかだからです。サービスはアカウントごとに有効化され、どのアカウントにも自社の予約、顧客、マークアップ、レポートを持つ管理画面があります。だから表の二行目の「なお作るもの」は見た目より短くなります。

連携会社にあなたの側を作らせるつもりなら、見積もりを受け入れる前にその相談をしてください。そうすれば作業範囲が、実際につなぐAPIを前提に書かれます。入口は旅行APIのページです。

弱い要件書が生む損失

サイトが公開されます。検索は動き、価格も正しそうで、最初の予約が木曜の夜に入ります。ところがあなたの名義では発券できません。仕入先アカウントが連携会社のもので、彼らの取り決めで発券されるからです。顧客のカードはすでに決済されています。あなたは自分のサイトでは発券も返金もできない予約を抱えることになります。

あるいは一年はうまく動きます。そこで仕入先が新しいAPIバージョンに移り、予約が止まり、引き渡しで固定価格の契約が終わった連携会社が新しいプロジェクトの見積もりを出します。あなたは払います。そのコードを理解しているのは見積もりを出した人たちだけだからです。

あるいは連携会社がほかの仕事で手一杯なだけかもしれません。顧客が航空券の名前を直したいのに、変更機能は最初から範囲外で、社員二人が午後いっぱい仕入先デスクにメールを書きます。サイトがなくしてくれるはずだった仕事そのものです。

どれも要件書から抜けていた一文が原因です。コードはどの場合も問題ありませんでした。

Tekravel 編集部

旅行テクノロジー担当

Tekravelの旅行テクノロジー担当は、業界の読者に向けて書いています。旅行会社の経営者、ホールセラー、そして両者をつなぐ開発者です。すべての記事は、公開前に記事が扱うプラットフォーム上で確認されます。