Mine sisu juurde
ShopentlyLearn

Päringud ja vastused

Vaata koos HTTP-olekut, tüübistatud JSON-andmeid ja päringu metaandmeid.

Päring

Content-Type: application/json
Saada JSON-muudatused päisega Content-Type: application/json.
data · meta
Edukad vastused sisaldavad data ja meta välju; kogumivastused kirjeldavad lisaks lehekülgedeks jaotamist.
error.code · error.message
Vead sisaldavad error.code, error.message ja vajaduse korral väljade teavet.

Andmetüübid

  • Kohustuslikkus ja null-i lubamine on sõltumatud.
  • Kohustuslik väli võib sisaldada null-i, kui skeem seda lubab.
  • Säilita JSON-i tõeväärtused, täisarvud, stringid ja null ilma tüübiteisenduseta.
  • Rahasummad on kümnendarvustringid; ära arvuta hindu binaarse ujukomaaritmeetikaga.

64-bit · expected_version

  • Mõni samaaegsuse kontrolli versioon kasutab märgiga 64-bitist täisarvu.
  • JavaScripti klient peab käsitlema väärtusi üle Number.MAX_SAFE_INTEGER kadudeta JSON-töötlusega ja saatma algse täisarvuesituse.
  • Ära ümarda versiooni ega teisenda seda JSON-stringiks.

Päised

Cache-ControlStringValikuline

Vastuse vahemälupoliitika.

const: "no-store"
X-Correlation-IDStringValikuline

Selle HTTP-päringu jälgimiseks kasutatav identifikaator.

WWW-AuthenticateStringValikuline

Serveri nõutav autentimisskeem.

AllowStringValikuline

Selle ressursi toetatud HTTP-meetodid.

Retry-AfterTäisarvValikuline

Minimaalne viivitus enne korduskatset, sekundites.

minimum: 0
LocationStringValikuline

Loodud ressursi suhteline URL.