Ugrás a tartalomhoz
ShopentlyLearn

Kérések és válaszok

A HTTP-állapotot, a típusos JSON-adatokat és a kérés metaadatait együtt értelmezze.

Kérés

Content-Type: application/json
JSON-alapú íráshoz használjon Content-Type: application/json fejlécet.
data · meta
A sikeres válasz data és meta mezőt tartalmaz; a listák válaszai lapozási adatokat is adnak.
error.code · error.message
A hibák error.code, error.message és adott esetben mezőszintű adatokat tartalmaznak.

Adattípusok

  • A kötelező jelleg és a null megengedése egymástól független.
  • Kötelező mező is tartalmazhat null értéket, ha a séma engedi.
  • A JSON logikai értékeit, egész számait, karakterláncait és null értékeit típuskonverzió nélkül őrizze meg.
  • A pénzösszegek tizedes számot tartalmazó karakterláncok; az árakat ne bináris lebegőpontos számokkal számolja.

64-bit · expected_version

  • Egyes verzióértékek előjeles 64 bites egész számok.
  • JavaScript-kliensben a Number.MAX_SAFE_INTEGER feletti értékekhez veszteségmentes JSON-kezelés szükséges, és az eredeti egész számot kell elküldeni.
  • A verziót ne kerekítse, és ne alakítsa JSON-karakterlánccá.

Fejlécek

Cache-ControlKarakterláncNem kötelező

A válasz gyorsítótárazási szabálya.

const: "no-store"
X-Correlation-IDKarakterláncNem kötelező

A HTTP-kérés nyomon követésére szolgáló azonosító.

WWW-AuthenticateKarakterláncNem kötelező

A szerver által megkövetelt hitelesítési séma.

AllowKarakterláncNem kötelező

Az erőforrás által támogatott HTTP-metódusok.

Retry-AfterEgész számNem kötelező

Az újrapróbálás előtti minimális várakozás másodpercben.

minimum: 0
LocationKarakterláncNem kötelező

A létrehozott erőforrás relatív URL-je.