Primeros pasos con la API v3

Requisitos

Para usar la API v3 de AgendaPro necesitas:

1. Tener un plan Pro activo.
2. Generar una API Key desde Configuraciones > Integraciones en tu cuenta de AgendaPro.

Autenticación

La API v3 usa autenticación por Bearer token. Incluye tu API Key en el header Authorization de cada request:

curl -H "Authorization: Bearer apk_live_tu_api_key" \
  https://connect.agendapro.com/v3/locations

Tu primera consulta

Obtén la lista de locales de tu empresa:

curl -H "Authorization: Bearer apk_live_tu_api_key" \
  https://connect.agendapro.com/v3/locations

Respuesta:

{
  "data": [
    {
      "id": 1,
      "name": "Sucursal Providencia",
      "address": "Av. Providencia 1234",
      "phone": "+56912345678",
      "email": "[email protected]"
    }
  ],
  "pagy": {
    "current_page": 1,
    "per_page": 30,
    "total_records": 1,
    "total_pages": 1
  }
}

Paginación

Todos los endpoints de listado retornan respuestas paginadas con un objeto pagy:

curl -H "Authorization: Bearer apk_live_tu_api_key" \
  "https://connect.agendapro.com/v3/bookings?page=2&per_page=50"

Rate Limits

Se aplican dos límites por empresa:

• Burst limit: máximo de requests por minuto.
• Daily quota: máximo de requests por día.

Los headers de respuesta incluyen el estado actual:

Cuando se excede cualquier límite, la API retorna 429 Too Many Requests con un header Retry-After.

Errores

Todas las respuestas de error usan el formato {error, detail}:

{
  "error": "unauthorized",
  "detail": "invalid_api_key"
}