Treci la conținut
ShopentlyLearn

Cereri și răspunsuri

Interpretați împreună starea HTTP, datele JSON cu tipuri explicite și metadatele cererii.

Cerere

Content-Type: application/json
Trimiteți cererile de scriere JSON cu Content-Type: application/json.
data · meta
Răspunsurile reușite conțin data și meta; răspunsurile pentru colecții descriu și paginarea.
error.code · error.message
Erorile conțin error.code, error.message și, dacă este cazul, informații despre câmpuri.

Tipuri de date

  • Caracterul obligatoriu al unui câmp și acceptarea valorii null sunt proprietăți independente.
  • Un câmp obligatoriu poate conține null dacă schema permite acest lucru.
  • Păstrați valorile booleene, numerele întregi, șirurile și null din JSON fără conversii automate.
  • Sumele monetare sunt șiruri zecimale; nu calculați prețuri folosind numere binare în virgulă mobilă.

64-bit · expected_version

  • Unele versiuni folosite pentru controlul concurenței sunt numere întregi cu semn pe 64 de biți.
  • Un client JavaScript trebuie să prelucreze JSON fără pierdere de precizie pentru valorile care depășesc Number.MAX_SAFE_INTEGER și să trimită reprezentarea întreagă originală.
  • Nu rotunjiți versiunea și nu o transformați într-un șir JSON.

Antete

Cache-ControlȘir de caractereOpțional

Politica de memorare în cache a răspunsului.

const: "no-store"
X-Correlation-IDȘir de caractereOpțional

Identificator folosit pentru urmărirea acestei cereri HTTP.

WWW-AuthenticateȘir de caractereOpțional

Schema de autentificare cerută de server.

AllowȘir de caractereOpțional

Metodele HTTP acceptate de această resursă.

Retry-AfterNumăr întregOpțional

Întârzierea minimă înainte de reîncercare, în secunde.

minimum: 0
LocationȘir de caractereOpțional

URL-ul relativ al resursei create.