La API de Factio usa API Keys para autenticar todas las solicitudes.
Obtener tu API Key
- Inicia sesión en app.factioapp.com.
- Ve a Configuración → API Keys.
- Haz clic en Crear API Key.
- Asigna un nombre descriptivo (ej:
ERP Producción).
- Copia la key inmediatamente — no se muestra de nuevo.
Tipos de API Key
| Prefijo | Entorno | Uso |
|---|
fct_live_ | Producción | Emisión real con efecto fiscal ante el SRI |
fct_test_ | Sandbox | Pruebas, sin efecto fiscal real |
Nunca incluyas tu API key en código fuente o repositorios.
Usa variables de entorno o un gestor de secretos.
Si una key queda expuesta, revócala inmediatamente desde el panel.
Cómo incluir la API Key en tus requests
Incluye la key en el header X-API-Key en cada request:
curl -X POST https://api.factioapp.com/documents \
-H "Content-Type: application/json" \
-H "X-API-Key: fct_live_TU_API_KEY_AQUI" \
-d '{ ... }'
import httpx
client = httpx.Client(
base_url="https://api.factioapp.com",
headers={"X-API-Key": "fct_live_TU_API_KEY_AQUI"},
)
Scopes (próximamente)
En una versión futura, las API Keys tendrán scopes configurables:
documents:write, documents:read, buyers:write, etc.
Por ahora, cada key tiene acceso completo al tenant que la generó.
Revocar una API Key
Desde Configuración → API Keys, selecciona la key y haz clic en Revocar.
Los requests en curso con esa key fallarán inmediatamente con 401. 
