本文へスキップ
ブログ

無料のホテル予約API、無料で実際に得られるもの

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

木曜の午後、デモは月曜です。無料のホテル予約APIを見つけ、メールアドレスで登録し、5分でキーを手に入れました。検索エンドポイントは、写真、星の数、1泊の料金付きでホテルを返してきます。夕方には結果ページもそれらしく見えます。金曜に予約の呼び出しをつなぐと、読めないエラーが返ってきます。登録したものは、そもそも予約を作れないものだったからです。

誰も嘘をついていません。この市場の「無料」は、まったく違う4つの商品に貼られているだけで、登録ページはどれを手にしているのかを教えてくれません。

「無料」が意味する4つのこと

この表はキーボードの横に置いておく価値があります。お使いの仕入先が違う行があれば、それも有益な発見です。

無料の中身得られるもの作れるものできないこと
静的コンテンツまたはディレクトリデータホテル名、住所、写真、設備、説明文ホテルガイド、地図、目的地ページ保証できる価格や、その日程に本当に空いている客室を見せること
リダイレクト型のアフィリエイト検索ホテルと価格、販売元自身の決済ページへのリンクトラフィックを外へ送る比較ページ顧客、決済、予約記録を自社側に残すこと
テスト料金付きのサンドボックス架空の在庫で応答する検索・料金・予約・キャンセルの全呼び出し本番のように動く連携とデモ実在のホテルが受け入れる予約を作ること
予約可能なライブ料金仕入先が確認した実在の客室、実際のネット料金または販売料金客室代金を受け取れる店契約に署名する側にとって無料であること

最初の3つが無料なのは、提供側がほとんど費用をかけずに配れるからです。4つ目が無料でないのは、誰かが実際のものを背負っているからです。

予約可能な料金にはなぜ必ず契約が付くのか

顧客が客室代金を支払うと、義務の連鎖が始まります。仕入先はホテルと契約しています。ホテルには客室代金が支払われると約束し、あなたにはその客室が存在すると約束しています。無料キャンセル期限を過ぎて宿泊客がキャンセルすれば、誰かがホテルに1泊分の借りを負います。料金が間違っていれば、誰かが差額を吸収します。カードが盗用されていれば、誰かがチャージバックの責任を負います。

これらはすべて、名前のある当事者に帰着しなければなりません。メールアドレスだけで誰でも発行できるAPIキーには担えないため、予約可能なアクセスには契約、精算の取り決め、そして多くの場合与信枠が付きます。「無料」のキーの代償は、提供側があなたの使い方を気にしなくてよいことです。

これは無料プランへの批判ではありません。コンテンツフィードは目的地ガイドには最適です。予約を受けるために必要なものと取り違えたときに限って、間違いになります。

選んだ1社の後ろに仕入先がいくつ必要かも検討中なら、ホテルAPIプロバイダーが何社必要かという記事で扱いました。同じ混乱の航空券版は無料の航空券APIの3つの種類という記事にあります。

最初の行の中にはもうひとつ罠があります。静的コンテンツとライブ料金は寿命の違う2つのフィードです。ホテルの説明文は数週間キャッシュに置けますが、今夜の料金は数分でも置けません。価格まで表示する無料のコンテンツフィードは、責任を持たない数字を引用しているのであり、その上に作ったページは昨日売り切れた客室を平然と表示します。

契約前にサンドボックスで試すこと

サンドボックスは表の中で最も役に立つ無料のものなので、使い倒してください。良いものは、実際の予約の全ステップを、偽物だが本物と同じ形の在庫で試させてくれます。

  1. 子供と複数の客室で検索する。 宿泊人数は、単純な連携が最初に壊れる場所です。別々の宿泊客がいる2部屋を要求し、応答がそれらを分けて返すか確認します。
  2. 予約前に価格を確認する。 多くの仕入先は、料金がまだ有効かを確かめる2回目の呼び出しを想定しています。サンドボックスにその手順がなければ、本番にはあるのか尋ねます。
  3. 予約して、返ってきたものを読む。 確定済みの客室、保留中のリクエスト、リクエスト制の客室は3つの異なる結果で、画面はどれなのかを示さなければなりません。
  4. 検索と予約の間に料金を変える。 料金は動きます。エラーはどう見え、コードは空白のページではなく新しい価格を顧客に見せられますか。
  5. 無料期間の内と外でキャンセルする。 キャンセルポリシーは、自分で解析する文章ではなく、日付と金額を持つ構造化データで届くべきです。
  6. わざと失敗させる。 不正な日付、未知のホテルコード、期限切れのトークンを送ります。エラーの形が何種類返ってくるか数えてください。

サンドボックスが4つ目と5つ目の手順をこなせないなら、手元にあるのは予約の形をしたURLを持つコンテンツAPIです。

誤った種類の上に作るコスト

この間違いの高くつく版は、失った1週間ではありません。うまくいったデモです。

関係者にきれいな検索ページを見せ、予算が承認され、そこで初めてチームは、裏のソースが客室を確定できないと知ります。コードがすべて無駄になるわけではありませんが、予約フロー、決済、キャンセル処理、精算は、フィールド名の異なる別の仕入先に合わせて作り直すことになります。見せた検索ページは、別のホテルを、別の価格で、別の順序で返すようになります。予算を承認した人は気づきます。

安上がりな習慣は、コードを1行書く前にひとつ尋ねることです。「このキーで、ホテルが受け入れる予約を作り、あとでキャンセルできますか」。答えが「はい」以外なら、4つのうちどれを手にしているかが分かります。

このプラットフォームの立ち位置

他の選択肢について率直に書いてきたのと同じ程度に、自社の立場についても率直に述べます。このプラットフォームは航空券とホテルのAPIを提供しており、アクセスはセルフサービスのキーではなく対話から始まります。表の4行目にあたります。予約可能な在庫の裏には、誰が尋ねているかを知る必要がある人がいます。ご自身の開発でどう使えるか知りたい場合は、旅行APIのページから始めて、何を作っているか教えてください。

無料のコンテンツ、アフィリエイトリンク、サンドボックスにはそれぞれ居場所があり、正しい選択は何を売る予定かで決まります。顧客が支払う日に、そのキーに何ができるかで選んでください。

Tekravel 編集部

旅行テクノロジー担当

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