API Keys
Autentica tus peticiones a la API de Pabilo de forma segura.
Obtener tu API Key
Para interactuar con la API de Pabilo, necesitas una API Key válida. Sigue estos pasos para obtenerla:
- Inicia sesión en tu cuenta de Pabilo.
- Navega a la sección de Integraciones en el menú lateral.
- Encontrarás tu API Key en el panel principal.
- Si no tienes una, puedes generarla haciendo clic en el botón "Generar Nueva API Key".
Importante
Tu API Key es confidencial. No la compartas en repositorios públicos ni en el lado del cliente (navegador).
Uso de la API Key
Debes incluir tu API Key en el header Authorization de cada petición HTTP que realices a nuestra API, utilizando el esquema Bearer.
GET /api/v1/resource HTTP/1.1
Host: api.pabilo.app
Authorization: Bearer tu_api_key_aqui
Content-Type: application/jsonCrear una API Key vía API
Además del panel, puedes generar API Keys programáticamente con el endpoint POST /auth/api-key.
Parámetros (body)
name— nombre descriptivo de la API Key.user_id— ID del usuario dueño de la API Key.client_owner_id(opcional) — asigna la API Key a un cliente al momento de crearla. Si se omite, la API Key se crea sin cliente asociado.
POST /auth/api-key
curl -X POST https://api.pabilo.app/auth/api-key \
-H "Authorization: Bearer TU_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Mi API Key",
"user_id": "USER_ID",
"client_owner_id": "CLIENT_ID"
}'Respuesta de Ejemplo
json
{
"message": "Api key created successfully",
"api_key": {
"id": "68b1a2c3d4e5f6a7b8c9d0e1",
"name": "Mi API Key",
"api_key": "b3f1c2d4-5678-90ab-cdef-1234567890ab",
"user_id": "USER_ID",
"default": false,
"is_active": true,
"client_owner_id": "CLIENT_ID"
}
}