1. REST API

キャッシング

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

クライアントは、必要に応じて応答をキャッシュできます。メディア コンテンツ (画像など) を含む要求の場合、ETagヘッダーが存在します。

同じリソースに対する次の要求で、クライアントはこのヘッダーの値をIf-None-Match headerで送信できます。これにより、サーバーは要求に対する応答が前の要求とまったく同じであると判断し、サーバーは304 Not Modifiedで応答します。これにより、キャッシュされた応答を再利用するようにクライアントに指示されるため、クライアントは帯域幅を大幅に節約できます。

リクエストの例:

GET http://<hostname>/api
Host: hostname
Accept: application/json

応答の例:

HTTP/1.1 200 OK
Content-Length: content length
Content-Type: application/json; charset=utf-8
ETag: "hash string"

{
  "entitydefinitions":{
    "href":"http://<hostname>/api/entitydefinitions",
    "title":"The collection of entity definitions."
  },
  "entities":{
    "href":"http://<hostname>/api/entities",
    "title":"The collection of entities."
  },
  "entitydefinition_by_name":{
    "href":"http://<hostname>/api/entitydefinitions/{name}",
    "title":"Get the entity definition with the spe...",
    "is_template":true
  },
  "entity_by_id":{
    "href":"http://<hostname>/api/entities/{id}",
    "title":"Get the entity with the specified id.",
    "is_template":true
  }
}

フォローアップリクエストの例:

GET http://<hostname>/api
Host: hostname
Accept: application/json
If-None-Match: "KEWz1VCrPJHbdBYEKfq4C3316wXW3VkwII61gtt8PO4="

フォローアップ応答の例:

HTTP/1.1 304 Not Modified
Content-Length: content length
Content-Type: application/json; charset=utf-8
ETag: "KEWz1VCrPJHbdBYEKfq4C3316wXW3VkwII61gtt8PO4="
この記事を改善するための提案がある場合は、 お知らせください!