Заявки и отговори

Разглеждайте заедно HTTP статуса, типизираните JSON данни и метаданните на заявката.

Заявка

Content-Type: application/json: Изпращайте записи в JSON с Content-Type: application/json.
data · meta: Успешните отговори съдържат data и meta; отговорите за списъци описват и странирането.
error.code · error.message: Грешките съдържат error.code, error.message и информация за полетата, когато е приложимо.

Задължителността и допустимостта на null са независими.
Задължително поле може да съдържа null, ако схемата го допуска.
Запазвайте JSON булевите стойности, целите числа, низовете и null без принудително преобразуване.
Паричните суми са десетични низове; не изчислявайте цени с двоична плаваща запетая.

Някои версии за контрол на едновременните записи използват 64-битови цели числа със знак.
JavaScript клиентът трябва да обработва JSON без загуба на точност за стойности над Number.MAX_SAFE_INTEGER и да изпраща първоначалното представяне на цялото число.
Не закръгляйте версията и не я преобразувайте в JSON низ.

Cache-ControlНизНезадължително: Политика за кеширане на отговора.

const: "no-store"
X-Correlation-IDНизНезадължително: Идентификатор за проследяване на тази HTTP заявка.
WWW-AuthenticateНизНезадължително: Схема за удостоверяване, изисквана от сървъра.
AllowНизНезадължително: HTTP методи, поддържани от този ресурс.
Retry-AfterЦяло числоНезадължително: Минимално изчакване преди повторение, в секунди.

minimum: 0
LocationНизНезадължително: Относителен URL на създадения ресурс.