Пређите на садржај
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 дозвољен.