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.
Métodos, autenticación, confirmaciones, paginación y errores.
Actualizado el 1 de enero de 1970
Todo lo que se puede hacer dentro de una marca en Nömad está definido una sola vez como capacidad. La misma capacidad la usa Nödo en el chat, un agente externo por MCP y una integración por HTTP. Hay 46 capacidades en 18 apartados; 8 ya están disponibles y el resto se activa por fases.
Estado. Esta es la especificación de la API. Las capacidades marcadas «Disponible» ya funcionan hoy a través de Nödo y del MCP piloto; los métodos HTTP y las claves con alcances se activan en la fase «Registro y MCP». Esta página cambia con el código.
Cada capacidad es un método: POST a su id con un cuerpo JSON que lleva la marca y la entrada. La respuesta es JSON con la salida tipada.
curl https://app.nomad.ooo/api/v1/works.list \
-H "Authorization: Bearer nmu_…" \
-H "Content-Type: application/json" \
-d '{ "brand": "WP-000", "status": "active", "limit": 10 }'{
"ok": true,
"data": {
"items": [{ "id": "…", "name": "Identidad visual", "status": "in_progress", "dueDate": null,
"progress": { "done": 3, "total": 7 }, "waitingOnBrand": 1 }],
"nextCursor": null
}
}nmu_… creadas en Ajustes › Seguridad y acceso. Cada clave actúa como la persona que la crea, con alcances y, si se quiere, limitada a unas marcas.El campo brand acepta el identificador corto (WP-121) o el UUID. Para saber qué marcas puede usar una clave, llama a brands.list.
Las escrituras que cambian algo que ven otras personas piden confirmación. Por HTTP, la primera llamada devuelve confirmation_required con un resumen y un confirmationToken de un solo uso; repite la llamada con ese token para ejecutarla. En el chat esto es el widget «Confirmar».
Toda escritura con expectedRevision falla con revision_conflict si el registro cambió entretanto: vuelve a leer y reintenta.
Las listas devuelven items y nextCursor. Pasa cursor para la siguiente página; limit va de 1 a 50.
| Código | HTTP | Qué significa |
|---|---|---|
unauthenticated | 401 | Falta la clave o no es válida. |
insufficient_scope | 403 | La clave no tiene el alcance; la respuesta dice cuál falta. |
forbidden | 403 | El rol de la persona no permite esta capacidad en esta marca. |
brand_not_operational | 409 | La marca está cerrada o archivada: solo lectura. |
confirmation_required | 409 | Hace falta confirmar; repite con el token. |
revision_conflict | 409 | El registro cambió; vuelve a leer. |
invalid_input | 422 | La entrada no cumple el esquema; se indica el campo. |
budget_exceeded | 402 | No queda presupuesto de IA en la marca este mes. |
rate_limited | 429 | Demasiadas llamadas; respeta Retry-After. |
Los cambios son aditivos: campos nuevos opcionales y capacidades nuevas. Un id publicado no cambia de significado; si hay que sustituirlo, el antiguo se mantiene mientras se anuncia el nuevo.