Перейти до вмісту
Sursa Developers

Час і формати

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"

У рядку запиту + треба записувати як %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 дозволено.