#Autenticación

Cada credencial de la API de Clarisfy es un par API key + API secret, emitido para un entorno concreto. Autenticas enviando ambos con HTTP Basic en el header Authorization.

#El par key + secret

Al crear una credencial obtienes dos valores:

El servidor solo almacena el sha256 del secret: si lo pierdes, genera una credencial nueva y revoca la anterior. El prefijo clf_ es amigable con el escaneo de secretos (herramientas como el secret-scanning de GitHub detectan una clave filtrada por su patrón).

#Entornos

Cada credencial vive en un entorno, marcado en el prefijo:

#Cómo autenticarte

El método canónico es HTTP Basic: la api_key va como usuario y el api_secret como contraseña (Authorization: Basic base64(api_key:api_secret)). Para pruebas rápidas también se acepta el api_secret solo como Bearer.

# HTTP Basic (recomendado): -u la codifica en base64 por ti
curl https://api.clarisfy.com/api/v1/fiscal-entities \
  -u "clf_live_key_2b7f9c1a4d8e6f30a1b2c3d4:clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe"

#Cómo se administran

Las credenciales se crean, rotan y revocan desde el Panel (Configuración → Desarrollo → API keys). Son:

• Por organización — pertenecen a tu Account, no a un usuario individual.
• Por entorno — eliges Producción o Desarrollo al crearlas.
• Rotables — genera una credencial nueva y revoca la anterior sin tiempo fuera de servicio.

#Errores de autenticación

Los errores devuelven el HTTP status correspondiente y un cuerpo { "detail": … }:

Ejemplo de respuesta 401:

{
  "detail": "invalid or revoked api credentials"
}