Horas y formatos
JSON y texto
- Los cuerpos de las solicitudes y de las respuestas son JSON en UTF-8, con
Content-Type: application/json. Las subidas de archivos usanmultipart/form-data. - Los nombres de los campos y los valores de enumeración están en
snake_case:next_retry_at,index_failed. - Los mensajes de error y los textos de la API están en inglés. Los textos que escribe usted, como los títulos de las tarjetas, se devuelven tal como los escribió, en cualquier idioma.
Horas
Cada hora es una marca de tiempo RFC 3339 en UTC:
{"created_at": "2026-10-24T10:00:00Z"}
- Los campos más recientes usan la forma corta con
Z, como arriba. - Algunos campos que ya existían usan la forma
2026-10-24T10:00:00.123456+00:00, con hasta seis cifras de fracciones de segundo. Es el mismo momento en UTC. Analice las dos formas con un analizador RFC 3339 estándar; no compare las marcas de tiempo como cadenas. - Todo campo cuyo nombre termina en
_ates una marca de tiempo.
Las horas que envíe deben incluir un desfase de zona horaria, ya sea Z o un desfase numérico como +02:00. Una hora
sin desfase es ambigua y devuelve 422 con el código validation.failed. Sursa
convierte a UTC todas las horas que recibe.
const since = new Date(Date.now() - 24 * 3600 * 1000).toISOString(); // "2026-10-23T10:00:00.000Z"En una cadena de consulta, el signo + debe escribirse como %2B; si no, se lee como un espacio. Codifique los valores
de hora para URL o use Z.
Fechas, duraciones y recuentos
| Tipo | Forma | Ejemplo |
|---|---|---|
| Fecha sin hora | YYYY-MM-DD, en un campo que termina en _date | "due_date": "2026-11-01" |
| Duración | Un entero, con la unidad en el nombre del campo | "interval_days": 90, "timeout_seconds": 30 |
| Recuento | Un entero, en un campo que termina en _count | "part_count": 12 |
| Verdadero o falso | Un booleano, con un adjetivo como nombre y sin is_ | "active": true, "sensitive": false |
Importes de dinero
Los importes de las respuestas financieras son cadenas decimales, como "1250.00", nunca números de coma flotante,
para que no se pierda precisión. La moneda es un campo aparte con un código ISO 4217, como "EUR". Analice los
importes con un tipo decimal de su lenguaje.
ID
Los ID son cadenas o enteros, según el objeto. Consulte ID de los objetos.
Enumeraciones
Los campos con un conjunto fijo de valores, como un estado, son cadenas. Cualquier enumeración de una respuesta puede recibir valores nuevos en una versión posterior: trate un valor que no conozca como «otro». Consulte Versiones y compatibilidad.
Campos nulos y ausentes
nullsignifica «sin valor»: una tarjeta sin responsable tiene"owner_id": null.- Un campo puede faltar en una respuesta cuando no se aplica a este objeto o a esta solicitud. La referencia de la API indica qué campos están siempre presentes.
- En un
PATCH, un campo que omita conserva su valor. Envíenullpara vaciar un campo cuando la referencia indique quenullestá permitido.