Време и формати
JSON и текст
- Телата на заявките и отговорите са JSON в UTF-8, с
Content-Type: application/json. При качване на файлове се използваmultipart/form-data. - Имената на полетата и стойностите на изброяванията са в
snake_case:next_retry_at,index_failed. - Съобщенията за грешки и текстовете на API са на английски. Текстовете, които пишете вие, например заглавията на картите, се връщат така, както сте ги написали, на всеки език.
Време
Всяко време е времеви печат по RFC 3339 в UTC:
{"created_at": "2026-10-24T10:00:00Z"}
- По-новите полета използват краткия запис със
Z, както по-горе. - Някои по-стари полета използват записа
2026-10-24T10:00:00.123456+00:00, с до шест цифри за частите от секундата. Това е същият момент в UTC. Обработвайте и двата записа със стандартен парсер за RFC 3339; не сравнявайте времевите печати като низове. - Всяко поле, чието име завършва на
_at, е времеви печат.
Времето, което изпращате, трябва да съдържа отместване на часовата зона – Z или числово отместване, например
+02:00. Време без отместване е двусмислено и връща 422 с кода validation.failed.
Sursa преобразува в UTC всяко получено време.
const since = new Date(Date.now() - 24 * 3600 * 1000).toISOString(); // "2026-10-23T10:00:00.000Z"В низа на заявката (query string) знакът + трябва да се запише като %2B, иначе се чете като интервал. Кодирайте
стойностите на времето за URL или използвайте Z.
Дати, продължителност и бройки
| Вид | Запис | Пример |
|---|---|---|
| Дата без час | YYYY-MM-DD, в поле, което завършва на _date | "due_date": "2026-11-01" |
| Продължителност | Цяло число, мерната единица е в името на полето | "interval_days": 90, "timeout_seconds": 30 |
| Бройка | Цяло число, в поле, което завършва на _count | "part_count": 12 |
| Истина или неистина | Булева стойност, наречена с прилагателно без is_ | "active": true, "sensitive": false |
Парични суми
Сумите във финансовите отговори са десетични низове, например "1250.00", а никога числа с плаваща запетая, за да
не се губи точност. Валутата е отделно поле с код по ISO 4217, например "EUR". Обработвайте сумите с десетичен тип
от вашия език.
Идентификатори
Идентификаторите са низове или цели числа според обекта. Вж. Идентификатори на обектите.
Изброявания
Полетата с фиксиран набор от стойности, например статус, са низове. Всяко изброяване в отговор може да получи нови стойности в по-късна версия: третирайте непозната стойност като „друго“. Вж. Версии и съвместимост.
null и липсващи полета
nullозначава „няма стойност“: карта без отговорник има"owner_id": null.- Поле може да липсва в отговора, когато не се отнася за този обект или за тази заявка. В справочника на API е отбелязано кои полета присъстват винаги.
- В
PATCHполе, което пропуснете, запазва стойността си. Изпратетеnull, за да изчистите поле, когато справочникът посочва, чеnullе допустимо.