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

木曜の午後、デモは月曜です。無料のホテル予約APIを見つけ、メールアドレスで登録し、5分でキーを手に入れました。検索エンドポイントは、写真、星の数、1泊の料金付きでホテルを返してきます。夕方には結果ページもそれらしく見えます。金曜に予約の呼び出しをつなぐと、読めないエラーが返ってきます。登録したものは、そもそも予約を作れないものだったからです。
誰も嘘をついていません。この市場の「無料」は、まったく違う4つの商品に貼られているだけで、登録ページはどれを手にしているのかを教えてくれません。
「無料」が意味する4つのこと
この表はキーボードの横に置いておく価値があります。お使いの仕入先が違う行があれば、それも有益な発見です。
| 無料の中身 | 得られるもの | 作れるもの | できないこと |
|---|---|---|---|
| 静的コンテンツまたはディレクトリデータ | ホテル名、住所、写真、設備、説明文 | ホテルガイド、地図、目的地ページ | 保証できる価格や、その日程に本当に空いている客室を見せること |
| リダイレクト型のアフィリエイト検索 | ホテルと価格、販売元自身の決済ページへのリンク | トラフィックを外へ送る比較ページ | 顧客、決済、予約記録を自社側に残すこと |
| テスト料金付きのサンドボックス | 架空の在庫で応答する検索・料金・予約・キャンセルの全呼び出し | 本番のように動く連携とデモ | 実在のホテルが受け入れる予約を作ること |
| 予約可能なライブ料金 | 仕入先が確認した実在の客室、実際のネット料金または販売料金 | 客室代金を受け取れる店 | 契約に署名する側にとって無料であること |
最初の3つが無料なのは、提供側がほとんど費用をかけずに配れるからです。4つ目が無料でないのは、誰かが実際のものを背負っているからです。
予約可能な料金にはなぜ必ず契約が付くのか
顧客が客室代金を支払うと、義務の連鎖が始まります。仕入先はホテルと契約しています。ホテルには客室代金が支払われると約束し、あなたにはその客室が存在すると約束しています。無料キャンセル期限を過ぎて宿泊客がキャンセルすれば、誰かがホテルに1泊分の借りを負います。料金が間違っていれば、誰かが差額を吸収します。カードが盗用されていれば、誰かがチャージバックの責任を負います。
これらはすべて、名前のある当事者に帰着しなければなりません。メールアドレスだけで誰でも発行できるAPIキーには担えないため、予約可能なアクセスには契約、精算の取り決め、そして多くの場合与信枠が付きます。「無料」のキーの代償は、提供側があなたの使い方を気にしなくてよいことです。
これは無料プランへの批判ではありません。コンテンツフィードは目的地ガイドには最適です。予約を受けるために必要なものと取り違えたときに限って、間違いになります。
選んだ1社の後ろに仕入先がいくつ必要かも検討中なら、ホテルAPIプロバイダーが何社必要かという記事で扱いました。同じ混乱の航空券版は無料の航空券APIの3つの種類という記事にあります。
最初の行の中にはもうひとつ罠があります。静的コンテンツとライブ料金は寿命の違う2つのフィードです。ホテルの説明文は数週間キャッシュに置けますが、今夜の料金は数分でも置けません。価格まで表示する無料のコンテンツフィードは、責任を持たない数字を引用しているのであり、その上に作ったページは昨日売り切れた客室を平然と表示します。
契約前にサンドボックスで試すこと
サンドボックスは表の中で最も役に立つ無料のものなので、使い倒してください。良いものは、実際の予約の全ステップを、偽物だが本物と同じ形の在庫で試させてくれます。
- 子供と複数の客室で検索する。 宿泊人数は、単純な連携が最初に壊れる場所です。別々の宿泊客がいる2部屋を要求し、応答がそれらを分けて返すか確認します。
- 予約前に価格を確認する。 多くの仕入先は、料金がまだ有効かを確かめる2回目の呼び出しを想定しています。サンドボックスにその手順がなければ、本番にはあるのか尋ねます。
- 予約して、返ってきたものを読む。 確定済みの客室、保留中のリクエスト、リクエスト制の客室は3つの異なる結果で、画面はどれなのかを示さなければなりません。
- 検索と予約の間に料金を変える。 料金は動きます。エラーはどう見え、コードは空白のページではなく新しい価格を顧客に見せられますか。
- 無料期間の内と外でキャンセルする。 キャンセルポリシーは、自分で解析する文章ではなく、日付と金額を持つ構造化データで届くべきです。
- わざと失敗させる。 不正な日付、未知のホテルコード、期限切れのトークンを送ります。エラーの形が何種類返ってくるか数えてください。
サンドボックスが4つ目と5つ目の手順をこなせないなら、手元にあるのは予約の形をしたURLを持つコンテンツAPIです。
誤った種類の上に作るコスト
この間違いの高くつく版は、失った1週間ではありません。うまくいったデモです。
関係者にきれいな検索ページを見せ、予算が承認され、そこで初めてチームは、裏のソースが客室を確定できないと知ります。コードがすべて無駄になるわけではありませんが、予約フロー、決済、キャンセル処理、精算は、フィールド名の異なる別の仕入先に合わせて作り直すことになります。見せた検索ページは、別のホテルを、別の価格で、別の順序で返すようになります。予算を承認した人は気づきます。
安上がりな習慣は、コードを1行書く前にひとつ尋ねることです。「このキーで、ホテルが受け入れる予約を作り、あとでキャンセルできますか」。答えが「はい」以外なら、4つのうちどれを手にしているかが分かります。
このプラットフォームの立ち位置
他の選択肢について率直に書いてきたのと同じ程度に、自社の立場についても率直に述べます。このプラットフォームは航空券とホテルのAPIを提供しており、アクセスはセルフサービスのキーではなく対話から始まります。表の4行目にあたります。予約可能な在庫の裏には、誰が尋ねているかを知る必要がある人がいます。ご自身の開発でどう使えるか知りたい場合は、旅行APIのページから始めて、何を作っているか教えてください。
無料のコンテンツ、アフィリエイトリンク、サンドボックスにはそれぞれ居場所があり、正しい選択は何を売る予定かで決まります。顧客が支払う日に、そのキーに何ができるかで選んでください。