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:

    1. Inicia sesión en tu cuenta de Pabilo.
    2. Navega a la sección de Integraciones en el menú lateral.
    3. Encontrarás tu API Key en el panel principal.
    4. Si no tienes una, puedes generarla haciendo clic en el botón "Generar Nueva API Key".

    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/json

    Crear 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"
        }
    }