Límites, versiones y cabeceras
Las cifras exactas de la API y del MCP de Nömad (peticiones por minuto, tamaño del cuerpo, paginación, caducidad y número de tokens) y las cabeceras, la versión y los documentos legibles por máquina.
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.
Las cifras exactas de la API y del MCP de Nömad (peticiones por minuto, tamaño del cuerpo, paginación, caducidad y número de tokens) y las cabeceras, la versión y los documentos legibles por máquina.
Esta página reúne los números que tu integración necesita para no chocar con un límite: cuánto puedes llamar, qué tamaño admite una petición, cuánto vive un token y qué cabeceras leer. Cómo se llama a un método, la idempotencia y los errores están en API de marca y Errores.
| Qué | Dirección |
|---|---|
| Base de la API | https://app.nomad.ooo/api/v1 |
| Llamar a una operación | POST /api/v1/{operación}, por ejemplo POST /api/v1/works.list |
| Quién eres y a qué llegas | GET /api/v1/me |
| Tus marcas, paginadas | GET /api/v1/me/brands |
| Especificación OpenAPI | GET /api/v1/openapi.json, con tu token (o con la sesión iniciada en Nömad) |
| Resumen para agentes | GET /api/v1/llms.txt, con tu token (?full=1 añade la descripción de cada operación) |
| Servidor MCP | https://app.nomad.ooo/api/mcp |
| Revocar un token filtrado | POST /api/credentials/revoke con { "token": "…" } |
La credencial va en Authorization: Bearer <token>. También se acepta la cabecera X-API-Key.
Todos los límites cuentan en ventanas de 60 segundos.
| Quién llama | Límite |
|---|---|
| Un token personal o de cuenta de servicio | 300 peticiones por minuto, por token |
| Una persona desde una app de Nömad, con su sesión | 600 peticiones por minuto |
| Credenciales incorrectas desde una misma dirección de red | 20 por minuto; después, 429 aunque la siguiente sea buena |
| Una conexión MCP (persona + cliente) | 240 peticiones JSON-RPC por minuto |
| Tokens MCP incorrectos desde una misma dirección | 20 por minuto |
Al pasarte respondemos 429 rate_limited con Retry-After en segundos. Espera ese tiempo antes de reintentar.
RateLimitCada respuesta con una credencial válida lleva:
RateLimit: limit=300, remaining=287, reset=42
| Campo | Significado |
|---|---|
limit |
Peticiones por minuto de esta credencial |
remaining |
Las que te quedan en la ventana actual |
reset |
Segundos hasta que empieza la siguiente ventana |
Consejo
Lee remaining y frena antes de llegar a cero: es más barato que gestionar un 429.
| Regla | Valor |
|---|---|
| Cuerpo máximo | 64 KB (65 536 bytes). Más grande: 413 payload_too_large. |
| Tipo de contenido | application/json. Otro tipo: 422 invalid_input. |
| Forma del cuerpo | Un objeto JSON; una lista o un JSON roto responden 422 invalid_input. Un cuerpo vacío cuenta como {}. |
| Resultado de una herramienta MCP | Como mucho 25 000 tokens. Más: result_too_large, con la pista de usar limit, format o cursor. |
| Dónde | limit |
Por defecto | Siguiente página |
|---|---|---|---|
Operaciones (POST /api/v1/…) |
1 a 50 | 20 | Pasa el nextCursor recibido como cursor |
GET /api/v1/me/brands |
1 a 100 | 50 | Pasa next_cursor como ?cursor= |
Los cursores son opacos: no los construyas ni los guardes mucho tiempo.
| Cabecera | Para qué | Reglas |
|---|---|---|
Authorization |
Tu credencial | Bearer nmu_live_v1_… o Bearer nmw_live_v1_… |
Content-Type |
El formato del cuerpo | application/json |
Idempotency-Key |
Que un reintento no escriba dos veces | 8 a 128 caracteres: letras, números, ., _, : y -. Vale 24 horas. |
X-Request-Id |
Usar tu propio identificador de petición | 8 a 64 caracteres del mismo juego. Si falta o no es válido, generamos uno. |
| Cabecera | Qué dice |
|---|---|
X-Request-Id |
El identificador de la petición. Cítalo si escribes a soporte. |
X-Nomad-Api-Version |
La versión mayor que respondió: v1. |
RateLimit |
Tu cuota del minuto (ver arriba). |
Retry-After |
En un 429, los segundos que debes esperar. |
Idempotent-Replayed |
true cuando la respuesta es la guardada de una llamada anterior con la misma clave. |
Cache-Control |
Siempre no-store: no guardes respuestas en cachés compartidas. |
WWW-Authenticate |
En un 401 unauthenticated o un 403 insufficient_scope, qué falta. |
| Qué | Valor |
|---|---|
| Versión mayor | v1, en la dirección (/api/v1) y en X-Nomad-Api-Version |
| Revisión del contrato | 2026-10-25, en info.version de openapi.json (v1 (2026-10-25)) |
| Protocolo MCP | 2026-07-28 |
Dentro de v1 los cambios son aditivos: campos opcionales nuevos y operaciones nuevas. Un nombre de operación publicado no cambia de significado; si hay que sustituirlo, el anterior sigue funcionando mientras se anuncia el nuevo. Tu cliente debe ignorar los campos que no conozca.
Para saber si algo cambió, compara la revisión de openapi.json con la última que leíste. llms.txt y openapi.json se generan del mismo contrato que usa la app, así que nunca describen algo distinto de lo que responde la API.
| Regla | Valor |
|---|---|
| Formato | <tipo>_live_v1_<prefijo 10 hex>_<secreto 64 hex>_<suma de control 8 hex>; nmu personal, nmw cuenta de servicio |
| Caducidad por defecto | 90 días |
| Caducidades que ofrece la pantalla | 7, 30, 90 o 365 días, un día que elijas (como mucho 366 días) o «Sin caducidad» |
| Aviso de caducidad | Una vez, 7 días antes |
| Tokens activos a la vez | 10 por titular (persona o cuenta de servicio) |
| Marcas a las que se puede limitar | Hasta 50 |
| Nombre | De 3 a 80 caracteres |
| Margen al rotar | El secreto anterior sigue 0, 1, 24 o 168 horas |
| Crear o rotar | Pide haber iniciado sesión hace menos de 10 minutos |
| Token de acceso OAuth del MCP | Caduca a la hora |
| Aprobación pendiente de un agente | Caduca a las 24 horas |
Un token limitado a unas marcas responde a una marca de fuera igual que a una que no existe (404 brand_not_found) y rechaza las operaciones de workspace (403 token_brand_restricted).
Para que tu escáner de secretos los detecte, usa este patrón:
\b(?:nma|nmu|nmw)_live_v1_[a-f0-9]{10}_[a-f0-9]{64}_[a-f0-9]{8}\b
Atención
Si un token aparece donde no debía (un repositorio, un registro, un chat), revócalo en Tu cuenta › Desarrolladores o envíalo a POST /api/credentials/revoke. La respuesta es siempre 202, exista o no.
Actualizado el 16 de noviembre de 2026