Kas yra entiteto antraštės?

HTTP entiteto antraščių (Entity Headers) yra metainformacija apie išteklių arba žinutės kūną, kuris perduodamas užklausoje arba atsakyme. Jie apibūdina turinį, bet ne patį išteklių.

Pagrindiniai entiteto antraštės:

• Content-Type: Nurodo žinutės kūno medijos tipą (MIME tipą), pavyzdžiui application/json, text/html, image/png.
• Content-Length: Žinutės kūno dydis baitais.
• Content-Encoding: Kodavimo (suspaudimo) metodas, taikomas žinutės kūnui, pavyzdžiui gzip, deflate.
• Content-Language: Turinio natūralioji kalba, pavyzdžiui ru, en-US.
• Content-Location: Alternatyvi išteklių vieta.
• Expires: Data/laikas, po kurio turinys laikomas pasenęs.
• Last-Modified: Paskutinio išteklių modifikavimo data/laikas.
• ETag: Unikalus išteklių versijos identifikatorius (dažnai turinio hash).

Pavyzdžiai naudojimo užklausoje ir atsakyme:

Užklausa (su kūnu):

POST /api/users
Host: example.com
Content-Type: application/json
Content-Length: 31

{
  "username": "john.doe",
  "email": "john@example.com"
}

Atsakymas (su kūnu):

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 50
ETag: "abcdef123456"
Expires: Tue, 05 Dec 2023 12:00:00 GMT

{
  "id": 123,
  "username": "john.doe",
  "email": "john@example.com"
}

Naudojami teisingam žinutės kūno apdorojimui ir interpretacijai kliento ir serverio, taip pat talpykloje ir sąlyginiuose užklausose.