この記事には、Vimeo APIを操作および使用するためのベストプラクティスが含まれています。
この記事では、次のことをご紹介します：
キャッシュ応答
Vimeoのメタデータのほとんどは頻繁に変更されることはありません（動画名、説明、埋め込みコードなど）。可能な限り、デベロッパはこれらの応答をキャッシュし、キャッシュから提供し、新しいメタデータが必要な時、または予期されるときにのみAPIにリクエストを送信する必要があります。 If-Modified-Sinceヘッダーなどのパラメーターを実装すると、この領域で役立ちます。詳細については、デベロッパページの「If-Modified-Sinceヘッダーの使用」をご覧ください。
フィールドフィルターを使用する
Vimeoへのリクエストの多くは大量のデータを返しますが、特定の情報のみ必要な場合は効率的ではありません。フィールドパラメーターを使用して、応答から必要なものを正確に指定すると、サーバーの負荷が軽減され、APIからの応答時間が長くなります。詳細については、「フィールドパラメーターを使用する」をご覧ください。フィールドパラメーターを使用すると、レート制限が高くなります。
レート制限を尊重する
Vimeoでは、レート制限を適用することで、すべてのデベロッパに安定したプラットフォームを保証しています。アプリケーションがレート制限を超えると、APIはHTTP 429エラーを返します。デベロッパはこれを予測し、レート制限の禁止が解除されるまでAPIへのリクエストを停止する必要があります。詳細については、「レート制限に関する操作」をご覧ください。
スクレイピングを避ける
スクレイピングとは、ウェブサイトからデータを抽出するアクションのことです。多くの場合、ウェブページを読み込んでスクリプトを実行し、ページから目的のデータを取得します。
データを取得するためにスクレイピングする代わりに、デベロッパは同じデータを取得するためにVimeoのAPIの1つを利用する必要があります。 APIの実装は、サイトをスクレイピングするよりも簡単かつ迅速です。
Vimeoに対してスクレイピングを行い、過剰なトラフィックを送信しているサーバーが検出された場合、そのサーバーのIPアドレスは予告なしに禁止されることがあります。サーバーのIPアドレスが禁止されていると思われる場合は、サポートに連絡して追加情報を提供してください。
公開文書化されたAPIのみを使用する
大胆なデベロッパは、Vimeoからデータを取得するために使用されるメタタグ、構成ファイル、またはその他のAPIを発見する可能性があります。詳しい知識のあるユーザーにアクセスできる場合もありますが、デベロッパはデベロッパサイトに記載されている公開APIのみを使用するようにしてください。これらの内部APIはサードパーティによる使用を目的としていないため、予告なしにいつでも変更される可能性があります。