Hopp til innholdet
Sursa Developers

Tid og formater

JSON og tekst

  • Brødteksten i forespørsler og svar er JSON i UTF-8, med Content-Type: application/json. Filopplastinger bruker multipart/form-data.
  • Feltnavn og enum-verdier skrives i snake_case: next_retry_at, index_failed.
  • Feilmeldinger og API-ets egne tekster er på engelsk. Tekster du skriver selv, for eksempel titler på kort, returneres slik du skrev dem, på hvilket som helst språk.

Tidspunkter

Alle tidspunkter er RFC 3339-tidsstempler i UTC:

{"created_at": "2026-10-24T10:00:00Z"}
  • Nyere felt bruker den korte formen med Z, som ovenfor.
  • Noen felt som fantes fra før, bruker formen 2026-10-24T10:00:00.123456+00:00, med opptil seks desimaler for brøkdeler av et sekund. Det er det samme øyeblikket i UTC. Tolk begge formene med en standard RFC 3339-parser, og ikke sammenlign tidsstempler som strenger.
  • Alle felt med navn som slutter på _at, er tidsstempler.

Tidspunkter du sender, må ha en forskyvning for tidssonen, enten Z eller en numerisk forskyvning som +02:00. Et tidspunkt uten forskyvning er tvetydig og returnerer 422 med koden validation.failed. Sursa konverterer alle tidspunkter den mottar, til UTC.

const since = new Date(Date.now() - 24 * 3600 * 1000).toISOString(); // "2026-10-23T10:00:00.000Z"

I en spørringsstreng må + skrives som %2B, ellers leses det som et mellomrom. URL-kod tidsverdier, eller bruk Z.

Datoer, varigheter og antall

TypeSkrivemåteEksempel
Dato uten klokkeslettYYYY-MM-DD, i et felt som slutter på _date"due_date": "2026-11-01"
VarighetEt heltall, med enheten i feltnavnet"interval_days": 90, "timeout_seconds": 30
AntallEt heltall, i et felt som slutter på _count"part_count": 12
Sann eller usannEn boolsk verdi, navngitt med et adjektiv uten is_"active": true, "sensitive": false

Pengebeløp

Beløp i økonomiske svar er desimale strenger, som "1250.00", aldri flyttall, slik at ingen presisjon går tapt. Valutaen er et eget felt med en ISO 4217-kode, som "EUR". Tolk beløp med en desimaltype i språket ditt.

ID-er

ID-er er strenger eller heltall, avhengig av objektet. Se Objektenes ID-er.

Enum-felt

Felt med et fast sett av verdier, for eksempel en status, er strenger. Hver enum i et svar kan få nye verdier i en senere versjon: Behandle en verdi du ikke kjenner, som «annet». Se Versjoner og kompatibilitet.

Null og manglende felt

  • null betyr «ingen verdi»: Et kort uten ansvarlig har "owner_id": null.
  • Et felt kan mangle i et svar når det ikke gjelder for dette objektet eller denne forespørselen. API-referansen viser hvilke felt som alltid er med.
  • I en PATCH beholder et felt du utelater, verdien sin. Send null for å tømme et felt der referansen sier at null er tillatt.