Saltar al contenido principal

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