La API de ClearPolicy usa tokens portadores para la autenticación. Cada solicitud debe incluir un token de API válido en el encabezadoDocumentation Index
Fetch the complete documentation index at: https://docs.clearpolicy.app/llms.txt
Use this file to discover all available pages before exploring further.
Authorization. Los tokens están vinculados a la organización donde se crearon, por lo que el token que uses determina qué datos de organización se devuelven.
Crear un token de API
Los propietarios y administradores de la organización pueden crear tokens de API en ClearPolicy.Crea un token
Haz clic en Crear token de API. Dale al token un nombre claro, como
Automatización de informes, para que tu equipo sepa dónde se usa.Copia el token portador
Copia el token cuando ClearPolicy lo muestre. No podrás volver a ver el token completo después de cerrar el cuadro de diálogo.
Pasar el token en las solicitudes
Incluye el token en el encabezadoAuthorization de cada solicitud a la API:
Respuestas de error
| Estado | Significado |
|---|---|
401 Unauthorized | El token falta, ha caducado o no es válido. |
403 Forbidden | El token es válido pero no tiene permiso para el recurso solicitado. |
Los tokens están vinculados a una organización. Todas las respuestas de la API reflejan la organización donde se creó el token.
El acceso a la API también sigue el rol del miembro del equipo en ClearPolicy. Los propietarios y administradores pueden crear y gestionar tokens de API. Los tokens vinculados a un gestor de grupo pueden confirmar el token con
GET /me, pero los endpoints de personas, documentos y solicitudes de acuse de recibo devuelven 403 Forbidden.