Solicitud
- Content-Type: application/json
- Envía las escrituras JSON con Content-Type: application/json.
- data · meta
- Las respuestas correctas contienen data y meta; las respuestas de colecciones incluyen además información de paginación.
- error.code · error.message
- Los errores contienen error.code, error.message e información de campos cuando corresponde.
Tipos de datos
- Obligatorio y nullable son propiedades independientes.
- Un campo obligatorio puede contener null si su esquema lo permite.
- Conserva los tipos JSON booleano, entero, cadena y null sin conversiones automáticas.
- Los importes monetarios son cadenas decimales; no calcules precios mediante coma flotante binaria.
64-bit · expected_version
- Algunas versiones para controlar cambios simultáneos utilizan enteros con signo de 64 bits.
- Un cliente JavaScript debe procesar JSON sin pérdida de precisión para los valores superiores a Number.MAX_SAFE_INTEGER y enviar la representación entera original.
- No redondees una versión ni la conviertas en una cadena JSON.
Cabeceras
Cache-ControlCadena de textoOpcionalPolítica de caché de la respuesta.
const:"no-store"X-Correlation-IDCadena de textoOpcionalIdentificador para rastrear esta solicitud HTTP.
WWW-AuthenticateCadena de textoOpcionalEsquema de autenticación exigido por el servidor.
AllowCadena de textoOpcionalMétodos HTTP admitidos por este recurso.
Retry-AfterNúmero enteroOpcionalEspera mínima antes de reintentar, en segundos.
minimum:0LocationCadena de textoOpcionalURL relativa del recurso creado.