API Keys
Las API Keys permiten integrar sistemas externos con facturAR de forma segura y programática. Cada key tiene un conjunto de scopes que definen qué operaciones puede realizar.
Crear una API Key
- Ir a API Keys en el menú lateral.
- Clic en Nueva API Key.
- Seleccionar los scopes necesarios:
invoices:read— consultar facturas.invoices:write— emitir facturas.companies:read— consultar empresas.companies:write— crear/modificar empresas.certificates:read— consultar certificados.certificates:write— gestionar certificados.
- Copiar la key generada (solo se muestra una vez).
Guardá la key de forma segura
La API Key se muestra una sola vez al crearla. No la compartas ni la expongas en repositorios públicos.
Usar la API Key
Incluí la key en el header Authorization de tus requests:
curl -H "Authorization: Bearer fk_live_abc123..." \
https://api.facturar.com.ar/v1/invoices
Revocar una API Key
Si una key se ve comprometida o ya no se necesita:
- Ir a API Keys.
- Buscar la key en la lista.
- Clic en Revocar.
La revocación es inmediata y no se puede deshacer.
Endpoints disponibles
| Método | Ruta | Scope requerido |
|---|---|---|
GET | /api/v1/invoices | invoices:read |
POST | /api/v1/invoices | invoices:write |
GET | /api/v1/invoices/:id | invoices:read |
GET | /api/v1/invoices/:id/pdf | invoices:read |
GET | /api/v1/companies | companies:read |
POST | /api/v1/companies | companies:write |
PATCH | /api/v1/companies/:id | companies:write |
GET | /api/v1/certificates | certificates:read |
POST | /api/v1/certificates | certificates:write |
Consultá la especificación OpenAPI para el detalle completo de cada endpoint.