Gå til indholdet
Sursa Developers

Tid og formater

JSON og tekst

  • Brødteksten i anmodninger og svar er JSON i UTF-8 med Content-Type: application/json. Filuploads bruger multipart/form-data.
  • Feltnavne og enum-værdier skrives i snake_case: next_retry_at, index_failed.
  • Fejlbeskeder og API’ets egne tekster er på engelsk. Tekster, du selv skriver, fx korttitler, returneres, som du skrev dem, uanset sprog.

Tidspunkter

Alle tidspunkter er RFC 3339-tidsstempler i UTC:

{"created_at": "2026-10-24T10:00:00Z"}
  • Nyere felter bruger den korte form med Z som ovenfor.
  • Nogle felter, der fandtes tidligere, bruger formen 2026-10-24T10:00:00.123456+00:00 med op til seks cifre for brøkdele af et sekund. Det er det samme tidspunkt i UTC. Fortolk begge former med en almindelig RFC 3339-parser, og sammenlign ikke tidsstempler som strenge.
  • Alle felter, hvis navn ender på _at, er tidsstempler.

Tidspunkter, du sender, skal have en tidszoneforskydning, enten Z eller en numerisk forskydning som +02:00. Et tidspunkt uden forskydning er tvetydigt og returnerer 422 med koden validation.failed. Sursa konverterer alle tidspunkter, den modtager, til UTC.

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

I en forespørgselsstreng skal et + skrives som %2B, ellers læses det som et mellemrum. URL-kod tidsværdier, eller brug Z.

Datoer, varigheder og antal

SlagsFormEksempel
Dato uden klokkeslætYYYY-MM-DD i et felt, der ender på _date"due_date": "2026-11-01"
VarighedEt heltal med enheden i feltnavnet"interval_days": 90, "timeout_seconds": 30
AntalEt heltal i et felt, der ender på _count"part_count": 12
Sand eller falskEn boolesk værdi, navngivet med et adjektiv uden is_"active": true, "sensitive": false

Pengebeløb

Beløb i økonomiske svar er decimaltal skrevet som strenge, fx "1250.00", aldrig flydende kommatal, så ingen præcision går tabt. Valutaen er et separat felt med en ISO 4217-kode, fx "EUR". Fortolk beløb med en decimaltype i dit programmeringssprog.

Id’er

Id’er er strenge eller heltal afhængigt af objektet. Se Objekt-id’er.

Enum-værdier

Felter med et fast sæt værdier, fx en status, er strenge. Alle enums i et svar kan få nye værdier i en senere version: Behandl en værdi, du ikke kender, som »andet«. Se Versioner og kompatibilitet.

Null og manglende felter

  • null betyder »ingen værdi«: Et kort uden ejer har "owner_id": null.
  • Et felt kan mangle i et svar, når det ikke gælder for dette objekt eller denne anmodning. API-referencen markerer, hvilke felter der altid er med.
  • I en PATCH beholder et felt, du udelader, sin værdi. Send null for at rydde et felt, hvor referencen siger, at null er tilladt.