Módulo "API (Interfaz)"

Reserve citas directamente desde su propia aplicación.

Con la API REST su sitio web, su portal de clientes, su app o su sistema CRM consultan las citas libres y crean reservas. Sus clientes permanecen así en su entorno habitual y no tienen que abrir el planificador de citas.

Sus ventajas de un vistazo

  • Su diseño, su proceso: El recorrido de reserva tiene exactamente el aspecto que usted desea.
  • Todo en un solo lugar: Las citas llegan de inmediato al planificador de citas, incluidos los emails de notificación habituales.
  • Implementación rápida: Seis llamadas en formato JSON reproducen el proceso de reserva completo.
  • Conexión segura: El acceso se realiza mediante un token que usted mismo genera y puede renovar en cualquier momento.

Ejemplos de uso

Recorrido de reserva propio

La reserva de citas se integra sin fisuras en el diseño de su sitio web.

App móvil

Sus clientes reservan citas directamente en su propia app.

CRM y software de consulta

Las citas se crean desde la aplicación con la que usted trabaja a diario.

Tienda y portal de clientes

La cita se asigna directamente en el proceso de pedido o en el área de socios.

Asistente telefónico con IA

Un asistente de voz atiende las llamadas, indica las citas libres y las reserva durante la conversación a través de la API.

Así se desarrolla una reserva

1. Calendario

Su aplicación consulta los calendarios de citas disponibles y selecciona el adecuado.

2. Motivo de cita

Para cada calendario la API facilita los servicios con descripción y duración.

3. Día

Solo se devuelven los días en los que realmente hay una cita libre.

4. Hora

Para el día seleccionado recibe todos los horarios de citas libres.

5. Campos de formulario

Qué datos solicita a sus clientes lo define usted en el planificador de citas. La API indica los campos correspondientes.

6. Reserva

La cita se reserva y, al hacerlo, se crean el registro del cliente y la cita.

Las citas reservadas a través de la API aparecen de inmediato en el planificador de citas y activan los emails de notificación habituales.

Ejemplo: reservar una cita

Solicitud

POST /api/bookings
Authorization: Bearer apm_ihr-token
Content-Type: application/json

{
    "schedule": 1,
    "reason": 1,
    "slot": "2026-05-23 09:00:00",
    "submission": {
        "first_name": "Hans",
        "last_name": "Pitt",
        "email": "hans.pitt@example.com"
    }
}

Respuesta

{
    "booking_id": 142,
    "booking_details_id": "a3f8c2d1e5b6",
    "user_id": 87,
    "slot": "2026-05-23T09:00:00Z"
}

Seguridad y funcionamiento

  • Acceso mediante token
    El token lo genera usted mismo en el área de administración en Configuración → API.
  • Visible una sola vez
    El token se muestra una única vez y en el sistema se guarda exclusivamente como hash.
  • Renovable en cualquier momento
    Si genera un token nuevo, el anterior pierde su validez de inmediato.
  • 300 solicitudes por minuto
    Margen suficiente para el funcionamiento continuo de su aplicación.

Más información

Guía

Paso a paso desde la activación y el token hasta la primera reserva, con ejemplos para cada llamada.

Ver la guía

Referencia

Todas las llamadas con parámetros, códigos de estado y esquemas, además de la descripción como archivo OpenAPI.

Ver la referencia

Webhooks

El sentido contrario: enviar automáticamente a una aplicación externa las citas nuevas, canceladas y modificadas.

Más información

¿Qué es una API?

Una breve explicación de la interfaz de programación y de sus posibilidades en el glosario.

Ver el glosario

¿Listo para más ingresos y menos trabajo?

Únase a Appointmind para crecer y tener éxito.

Ver otros módulos.