Skip to main content
La API pública se sirve bajo /v1 en el origen de tu panel de Failproof AI.

​
Crear una clave y realizar una solicitud

  1. Abre Administración → Claves, selecciona Crear clave y elige el conjunto de permisos más restringido que cubra la integración.
  2. Añade permisos individuales solo cuando sea necesario, crea la clave y copia su secreto de uso único.
  3. Realiza una solicitud de prueba a /v1/sessions y confirma que la clave permanece activa en la página de Claves.
  4. Rota o deshabilita la clave desde su menú de acciones cuando la integración cambie de propietario. El panel de creación de nueva clave API con los conjuntos de permisos y los permisos individuales.
El panel de creación se muestra arriba. El secreto de uso único aparece solo después de seleccionar crear; cópialo antes de cerrar esa confirmación.
Las claves están vinculadas a una organización y a un conjunto de permisos. Una solicitud que no cuente con el permiso requerido por el endpoint devuelve 403 e identifica el permiso que falta.

​
Selección de organización

Una clave de organización actúa automáticamente sobre su propia organización. Una clave con ámbito de instancia puede seleccionar una organización por solicitud:
Usa el selector de organización en el encabezado del panel antes de abrir Administración → Claves. Las claves creadas allí pertenecen a la organización seleccionada. Confirma el slug de la organización en la URL y en el detalle de la clave antes de copiar la credencial en la automatización.
Consulta las páginas de endpoints generadas en esta sección para conocer las rutas actuales, los parámetros, los requisitos de permisos y los códigos de estado. La especificación se genera a partir de las anotaciones de rutas del servidor y se verifica contra el enrutador /v1. La especificación actual tiene cobertura completa de rutas, métodos, parámetros, permisos y códigos de estado. Algunos cuerpos de respuesta permanecen intencionalmente sin tipo porque el servidor aún los construye como JSON dinámico. Inspecciona una respuesta real antes de generar un cliente con tipado estricto para un endpoint que no tenga esquema de respuesta definido. Usa Content-Type: application/json para escrituras en JSON. Interpreta 401 como autenticación ausente o inválida, 403 como una identidad válida sin el permiso requerido, 404 como un recurso inexistente o inaccesible para la organización, 409 como un conflicto de estado, y 422 como un campo o valor de permiso inválido. Las respuestas de error incluyen un mensaje legible por humanos; los fallos de permiso también indican el permiso requerido.
El despliegue de la aplicación de políticas se gestiona intencionalmente fuera de la superficie pública /v1 ordinaria. Utiliza el flujo de despliegue en la nube compatible.