> ## Documentation Index
> Fetch the complete documentation index at: https://docs.noimosai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Autenticar solicitudes

> Claves API, permisos, vencimiento y gestión segura de Developer Platform.

## Descripción general

Esta página explica autenticación, permisos, vencimiento y almacenamiento de claves de Developer Platform. Cada clave está vinculada a un proyecto y solo permite las operaciones autorizadas.

## Usar una clave de Developer Platform

Envía este encabezado Authorization en todas las solicitudes.

```http theme={null}
Authorization: Bearer nmp_...
```

Las claves de los ajustes habituales del equipo utilizan espacios de trabajo, sus permisos y créditos de NoimosAI. Las de Developer Platform utilizan proyectos, permisos y saldos prepagados en USD independientes.

| Clave | Destino | Datos | Facturación |
| - | - | - | - |
| `nmp_` | Developer Platform API | Proyectos de desarrollador, ejecuciones y artefactos | Saldo prepagado en USD |
| Clave API habitual de NoimosAI | CLI, Local MCP, API de herramientas habitual | Espacio de trabajo de NoimosAI | Créditos de NoimosAI |

> [!WARNING]
>
> Las claves no son intercambiables. Una clave inválida, permisos insuficientes o saldo insuficiente nunca provocan un cambio automático de autenticación o facturación.

## Configurar los permisos

Selecciona los permisos necesarios al crear la clave.

| Permiso | Operaciones permitidas |
| - | - |
| `project:read` | Consultar organización y proyecto de la clave |
| `usage:read` | Consultar uso liquidado y cargos en USD del mes actual |
| `tools:read` | Obtener el catálogo y presupuestos gratuitos |
| `tools:execute` | Subir entradas, ejecutar trabajo de pago y cancelarlo |
| `executions:read` | Obtener estado, resultados y URL de descarga de artefactos |

Separa las claves de comprobación de conexión de las que ejecutan trabajo de pago para reducir ejecuciones accidentales. Revisa todos los permisos para consultar el proyecto, presupuestar, ejecutar y obtener resultados.

## Quién puede crear claves

Los miembros `ADMIN` o `DEVELOPER` del proyecto pueden crearlas. Incluso un administrador de la organización necesita pertenencia explícita al proyecto para acceder.

Se aplican los permisos del creador y del proyecto. La clave deja de funcionar si se desactiva la cuenta del creador, se le retira del proyecto o se revoca la clave.

## Gestionar el vencimiento

Selecciona la caducidad en la pantalla de creación de claves de Developer Platform y compruébala en la lista tras crearla. La clave completa solo se muestra una vez; guárdala de forma segura antes de cerrar la pantalla.

Antes de vencer, crea otra clave, actualiza las integraciones y revoca la anterior. Revócala inmediatamente si sospechas una filtración.

## Guardar las claves de forma segura

Trátalas como secretos del servidor que nunca se distribuyen a los navegadores de los usuarios.

* Guárdalas en variables de entorno o un gestor de secretos.
* No las registres en Git, logs, pantallas de error ni eventos analíticos.
* No las incrustes en aplicaciones web o móviles.
* Separa claves y proyectos de producción, pruebas y desarrollo.
* Crea claves por uso con los permisos mínimos.

## Resolver errores de autenticación

Revisa el estado HTTP y el estado de la clave.

* `401` — Revisa Authorization, clave completa, vencimiento y revocación.
* `403` — Revisa permisos necesarios y acceso del propietario al proyecto.
* `429` — Revisa límites de solicitudes, saldo y topes mensuales de organización o proyecto.

Si no sabes si la clave corresponde al endpoint, usa `GET /tools/project` antes de enviar trabajo de pago.

## Páginas relacionadas

Consulta estas páginas para crear claves y revisar especificaciones comunes.

* [Primeros pasos](https://docs.noimosai.com/es/developers/api/getting-started.md)
* [Referencia de la API](https://docs.noimosai.com/es/developers/api/reference.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.