Saltar al contenido

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.

Política de privacidadPolítica de cookies
Docs
GuíasDesarrolladores
Español
EspañolEnglishFrançaisDeutschItaliano

Empezar a desarrollar

  • Tu primera llamada a la API
  • Límites, versiones y cabeceras

API

  • API de marca

MCP

  • Servidor MCP

Conectores

  • Conectores de una marca
Empezar a desarrollar
Referencia4 min de lectura

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.

Português
Русский
한국어
日本語
中文
हिन्दी
Abrir la app
En esta página
  • Direcciones
  • Límites de peticiones
  • La cabecera RateLimit
  • Tamaño y formato
  • Paginación
  • Cabeceras
  • Las que envías
  • Las que recibes
  • Versiones
  • Tokens

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.

Direcciones

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.

Límites de peticiones

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.

La cabecera RateLimit

Cada 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.

Tamaño y formato

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.

Paginación

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.

Cabeceras

Las que envías

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.

Las que recibes

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.

Versiones

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.

Tokens

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.

Sigue leyendo

  • Tu primera llamada a la APICrea un token personal, comprueba quién eres con GET /api/v1/me, lista tus marcas y lee sus trabajos; después conecta un agente por MCP.
  • API de marcaMétodos, autenticación, escrituras, idempotencia, paginación y errores.
  • ErroresCada código de error, su estado HTTP y qué hacer.
  • Tokens y cuentas de servicioCrear, limitar, rotar y revocar tokens personales y de la organización.

Actualizado el 16 de noviembre de 2026

AnteriorTu primera llamada a la APISiguienteAPI de marca
¿No encuentras lo que buscas? EscríbenosEscríbenosIr a la app
© 2026 Nömad · Documentación de NömadLinkedInInstagramThreadsFacebookTikTokYouTubeX
Ir a nomad.oooVolver arriba

En esta página

  • Direcciones
  • Límites de peticiones
  • La cabecera RateLimit
  • Tamaño y formato
  • Paginación
  • Cabeceras
  • Las que envías
  • Las que recibes
  • Versiones
  • Tokens