Anar al contingut
Sursa Developers

Temps i formats

JSON i text

  • Els cossos de les sol·licituds i de les respostes són JSON en UTF-8, amb Content-Type: application/json. Les pujades de fitxers fan servir multipart/form-data.
  • Els noms dels camps i els valors d’enumeració són en snake_case: next_retry_at, index_failed.
  • Els missatges d’error i els textos de l’API són en anglès. Els textos que escriviu, com ara els títols de les entrades, es retornen tal com els heu escrit, en qualsevol llengua.

Marques de temps

Tots els moments són marques de temps RFC 3339 en UTC:

{"created_at": "2026-10-24T10:00:00Z"}
  • Els camps més nous fan servir la forma curta amb Z, com aquí dalt.
  • Alguns camps que ja existien abans fan servir la forma 2026-10-24T10:00:00.123456+00:00, amb fins a sis xifres de fracció de segon. És el mateix moment en UTC. Analitzeu totes dues formes amb un analitzador estàndard de RFC 3339; no compareu les marques de temps com a cadenes.
  • Tots els camps amb un nom acabat en _at són marques de temps.

Els moments que envieu han d’incloure el desplaçament del fus horari, sigui Z o un desplaçament numèric com ara +02:00. Un moment sense desplaçament és ambigu i retorna 422 amb el codi validation.failed. Sursa converteix a UTC tots els moments que rep.

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

En una cadena de consulta, un + s’ha d’escriure com a %2B; si no, es llegeix com un espai. Codifiqueu per a URL els valors de temps o feu servir Z.

Dates, durades i recomptes

TipusFormaExemple
Data sense horaYYYY-MM-DD, en un camp acabat en _date"due_date": "2026-11-01"
DuradaUn enter, amb la unitat al nom del camp"interval_days": 90, "timeout_seconds": 30
RecompteUn enter, en un camp acabat en _count"part_count": 12
Cert o falsUn booleà, amb el nom d’un adjectiu sense is_"active": true, "sensitive": false

Imports de diners

Els imports de les respostes financeres són cadenes decimals, com ara "1250.00", i mai nombres de coma flotant, perquè no es perdi precisió. La moneda és un camp a part amb un codi ISO 4217, com ara "EUR". Analitzeu els imports amb un tipus decimal del vostre llenguatge.

ID

Els ID són cadenes o enters segons l’objecte. Vegeu ID dels objectes.

Enumeracions

Els camps amb un conjunt fix de valors, com ara un estat, són cadenes. Qualsevol enumeració d’una resposta pot rebre valors nous en una versió posterior: tracteu un valor que no conegueu com a «altre». Vegeu Versions i compatibilitat.

Camps nuls i absents

  • null vol dir «sense valor»: una entrada sense responsable té "owner_id": null.
  • Un camp pot faltar en una resposta quan no s’aplica a aquest objecte o a aquesta sol·licitud. La referència de l’API indica quins camps hi són sempre.
  • En un PATCH, un camp que ometeu conserva el seu valor. Envieu null per buidar un camp quan la referència diu que s’admet null.