ニュース

移行ガイド:プロバイダーの切り替えに関する情報の新しい拠点

互換ホストがあると知っていることと、既存の連携を途中で何も壊さずにそこへ移す具体的な方法を知っていることは別の話です。そのギャップを埋めるために専用の移行ガイドを作成し、/docs/compatibility/にまとめました。

ガイドでは、切り替えの実践的な手順を、プロバイダーごと、エンドポイントごとに順を追って説明しています。リクエストで何が変わり何が変わらないのか、どの認証方式を使うのか、レスポンスで何に注意すべきかといった内容です。当社の17の互換ホストはいずれも、著作権、利用規約、プライバシーに関する文言を除き、元のプロバイダーのリクエストとレスポンスの形を正確に再現しているため、ガイドは主に本当に異なる部分に焦点を当てています。向け先となるホスト名、発行すべきキー、そしてすべてのレスポンスに付くようになる割り当てのヘッダーです。

これらのガイドは、特定の読者を想定して書きました。すでに別のプロバイダー向けに動作するコードを持っていて、当社に向けても動き続けるという約束だけでなく確信を得たい人です。つまり、移行期間中の料金についても明確にするということです。すべてのエンドポイントとすべての互換ホストは同じ料金で、どのアドレスからでも1日あたり2,500リクエストが無料、さらにキーごとに1日あたり2,500リクエストが無料なので、本格的に移る前の移行テストには費用がかかりません。

各ガイドでは、放置すると移行でつまずきやすい細かな点も扱っています。バッチリクエストのカウント方法(一括呼び出しは呼び出し全体ではなく各項目を個別にカウントします)や、初めて目にする場合のために、各レスポンスに付く追加の割り当てヘッダーの意味などです。該当するガイドをコードの隣に開いておけば、推測に頼る必要はありません。

移行するかどうかを検討しているチームにおすすめの進め方はシンプルです。現在使っているプロバイダーのガイドを読み、キーを発行し、本番のコードに手を付ける前に互換ホストに対していくつか実際のリクエストを試します。そのテストは無料枠で完全にまかなえるため、判断する前に両者を並べて比較しても費用はかかりません。

これらのガイドが扱う互換ホストの一覧は/compatibility/にあり、すべてに共通する認証とレート制限の一般的なドキュメントは/docs/authentication//docs/rate-limits/にあります。互換性の対象が広がるのに合わせて、このガイド集も拡充していく予定です。