Saltar al contenido principal

GuíasConvenciones

Convenciones

HTTPS, JSON, /api/v1 en el path, UUIDs, timestamps UTC.

ReglaDetalle
ProtocoloHTTPS en producción. Cuerpos JSON UTF-8.
VersiónEn el path: /api/v1. No en un header.
IDsid de recurso es UUID.
TimestampsISO-8601 UTC (2026-08-20T15:00:00.000Z).
Nullnull explícito = sin valor. Omitir en PATCH = no cambiar.
Claves extraRechazadas en escritura (additionalProperties: false).
Claves desconocidas en la respuestaIgnóralas. Pueden aparecer campos aditivos en /api/v1.
MétodosGET lista/get, POST crea, PATCH actualiza. DELETE solo en webhooks y tags/participantes del inbox.