Disponible ahora · Plan Pro Total y Enterprise

API REST de Ariah

Conecta Ariah con tu CRM, Make, Zapier, Google Sheets o tu propia app. REST clásico, autenticación Bearer. Ya disponible para todas las clínicas en plan Pro Total y Enterprise — pide tu API key desde Ajustes → API.

Las dueñas en Pro o Básico pueden actualizar plan para activarla

Autenticación

Todas las llamadas requieren una cabecera Authorization: Bearer ariah_xxx. Las keys se crean en tu dashboard → Ajustes → API (solo dueña / superadmin). Se muestran una sola vez al crear — guárdalas en un gestor de contraseñas.

curl -H "Authorization: Bearer ariah_xxx..." \
     https://app.ariah.es/api/v1/citas

Endpoints

GET/api/v1/citas

Lista las citas en un rango de fechas.

Parámetros

desde — YYYY-MM-DD (default: hoy)
hasta — YYYY-MM-DD (default: hoy + 30d)
limit — 1-500 (default: 100)

Respuesta

{
  "citas": [
    {
      "id": "uuid",
      "fecha_hora": "2026-06-08T10:00:00+02:00",
      "cliente_nombre": "Marta López",
      "telefono": "+34600000000",
      "servicio": "Limpieza facial",
      "duracion_min": 60,
      "precio": 45,
      "estado": "Confirmada",
      "profesional_nombre": "Lucía",
      "sede_nombre": "Marbella",
      "notas": null,
      "created_at": "..."
    }
  ],
  "total": 1,
  "rango": { "desde": "...", "hasta": "..." }
}

GET/api/v1/clientas

Lista tus clientas. Soporta búsqueda y paginación.

Parámetros

q — buscar por nombre o teléfono
vip — "true" para solo VIPs
limit — 1-500 (default: 200)
offset — para paginar

Respuesta

{
  "clientas": [
    {
      "id": "uuid",
      "nombre": "Marta López",
      "telefono": "+34600000000",
      "email": "marta@...",
      "idioma": "es",
      "vip": true,
      "total_citas": 12,
      "total_llamadas": 18,
      "ultima_cita": "2026-05-20",
      "ultima_llamada": "...",
      "cliente_desde": "2024-03-12",
      "created_at": "..."
    }
  ],
  "total": 899,
  "limit": 200,
  "offset": 0
}

GET/api/v1/llamadas

Lista llamadas atendidas por Lucía.

Parámetros

desde — YYYY-MM-DD (default: hoy - 7d)
limit — 1-500 (default: 100)
resultado — agendada | cancelada | info | transferida | sin_accion

Respuesta

{
  "llamadas": [
    {
      "id": "uuid",
      "fecha_hora": "...",
      "cliente_nombre": "Marta López",
      "telefono_caller": "+34600000000",
      "duracion_segundos": 180,
      "resultado": "agendada",
      "idioma": "es",
      "created_at": "..."
    }
  ],
  "total": 1,
  "desde": "..."
}

Códigos de error

401 missing_api_key · Falta el header Authorization.
401 invalid_api_key · La key no existe, está revocada o ha expirado.
500 database_error · Error interno; reintenta en unos segundos.

Rate limits

Sin límites duros por ahora. Si abusas (más de 60 req/s mantenido), recibirás un 429 too_many_requests con cabecera Retry-After.

¿Te interesa la API?

La API está incluida en el plan Premium. Si quieres una integración a medida, hablamos.

Ver planes Hablar con Tristán