Cambios
Qué ha cambiado en la API de marca y cuál es la revisión vigente del contrato.
Privacidad y analítica
Utilizamos cookies técnicas necesarias y, solo si das tu consentimiento, analítica y pixels de marketing para mejorar la web y medir campañas.
Qué ha cambiado en la API de marca y cuál es la revisión vigente del contrato.
Lo que cambia en la API de marca que una integración puede notar, lo más nuevo primero. La fecha de la primera entrada es la revisión del contrato: llega en X-Nomad-Api-Revision y en info.version de openapi.json. Cambiar la forma de una operación publicada exige una entrada aquí; una prueba lo comprueba en cada cambio de código.
El contrato empieza a llevar registro de cambios y la revisión que anuncia es la de su última entrada (cabecera X-Nomad-Api-Revision e info.version de openapi.json). Novedades: 500 internal_error para un fallo nuestro que no se arregla repitiendo la llamada (antes 503 unavailable), solo por la API con token; Accept-Language elige el idioma de los textos que redacta Nömad; las lecturas llevan ETag y responden 304 a If-None-Match; una operación en retirada lo dice con Deprecation, Sunset y Link: rel="successor-version"; brands.list acepta limit y cursor y devuelve nextCursor; orders.list, activity.list y publishing.ideas.list paginan con un cursor que no se desplaza cuando entran filas nuevas. Del mismo día (roles y credenciales): una operación que mueve dinero (cambiar o cancelar el plan, comprar) pedida con un token o una cuenta de servicio ya no se ejecuta al momento: responde 202 approval_required y espera a que su titular la apruebe en Nömad; y un token puede limitarse a unas operaciones concretas, fuera de las cuales responde 403 insufficient_scope con el nombre de la operación. Entre el 2026-10-25 y hoy el contrato creció sin registro: solo con operaciones y campos opcionales nuevos.
Primera revisión: una operación por capacidad en POST /api/v1/{operación}, tokens personales y cuentas de servicio, errores RFC 9457, Idempotency-Key y cabeceras RateLimit.