Centro para desarrolladores y API pública
Todo lo que los desarrolladores necesitan para integrar yAppointment en sus propios productos: una REST API pública, OAuth 2.1 para acceso delegado por el usuario, webhooks firmados y un TypeScript SDK listo para usar.
Read the DocsUna plataforma completa para desarrolladores
Bloques de construcción listos para producción que conectan yAppointment con tus aplicaciones, flujos de trabajo e integraciones
REST API pública
Una REST API limpia y predecible en /api/v1 para leer y escribir datos de tu empresa, reservas y clientes, con claves de idempotencia para que los reintentos nunca generen dobles reservas.
- Lee y escribe datos de empresa, reservas y clientes
- Creación de reservas idempotente con claves de idempotencia
- Gestiona tus endpoints de webhook de forma programática
- Precios devueltos en unidades menores (céntimos) para cálculos precisos
- Respuestas JSON consistentes y bien estructuradas
OAuth 2.1 + PKCE
Permite que tus usuarios conecten su cuenta de yAppointment a tu aplicación de forma segura con el flujo Authorization-Code y PKCE: sin compartir contraseñas, solo acceso con ámbitos limitados.
- Flujo Authorization-Code con PKCE para acceso delegado seguro
- Ámbitos granulares: read/write:bookings y read/write:customers
- Acceso al perfil y analíticas mediante read:profile y read:analytics
- Gestión de webhooks a través del ámbito webhooks:manage
- Los usuarios otorgan acceso sin compartir nunca sus credenciales
Claves de API de servidor y públicas
Emite claves de servidor (yapp_sk_*) para integraciones backend y claves públicas (yapp_pk_*) para uso en el lado del cliente, con entornos de producción y prueba completamente separados.
- Claves de servidor (yapp_sk_*) para llamadas de servidor a servidor de confianza
- Claves públicas (yapp_pk_*) para uso seguro en el lado del cliente
- Entornos de producción y prueba separados para desarrollar con confianza
- Rota las claves en cualquier momento desde tu panel de control
- Prueba con datos sandbox antes de entrar en producción
Webhooks firmados
Recibe notificaciones en el momento en que algo cambia. yAppointment entrega 9 tipos de eventos a tus endpoints HTTPS con reintentos automáticos y seguimiento completo de entregas.
- 9 tipos de eventos que cubren reservas, clientes, servicios y empleados
- Eventos booking.created, booking.updated y booking.cancelled
- Endpoints exclusivamente HTTPS con un secreto de firma whsec_
- Firmas HMAC-SHA256 en la cabecera yapp-signature
- Reintentos automáticos con seguimiento de entregas y entregas de prueba desde el panel
Getting Started
Start building with our SDK or REST API in minutes. Full documentation and interactive examples at developers.yappointment.com.
View Documentationimport { YAppointmentClient } from
'@lohisoftsro/yappointment-sdk';
const client = new YAppointmentClient({
apiKey: process.env.API_KEY,
baseUrl: 'https://api.yappointment.com'
});
// Create a booking
const booking = await client.bookings.create({
serviceId: 'srv_123',
customerId: 'cst_456',
startTime: '2025-07-01T10:00:00Z',
idempotencyKey: 'req_xyz789'
});
console.log('Booked:', booking.id);Diseñado para una gran experiencia del desarrollador
Las herramientas y la documentación que hacen que integrar yAppointment sea rápido y agradable
TypeScript SDK
Olvídate del código repetitivo con nuestro TypeScript SDK oficial en npm: @lohisoftsro/yappointment-sdk, generado directamente desde nuestra especificación OpenAPI, con soporte para ESM y CJS.
Documentación interactiva para desarrolladores
Explora cada endpoint en developers.yappointment.com con una referencia interactiva de API Scalar que puedes leer, buscar y probar mientras construyes.
Modos de producción y prueba
Claves de API de producción y prueba separadas te permiten construir y experimentar con seguridad, y luego pasar a producción cuando estés listo, sin tocar datos reales.
Reintentos seguros
Las claves de idempotencia hacen que la creación de reservas sea segura para reintentar, de modo que los problemas de red nunca se conviertan en citas duplicadas.
¿Listo para ver qué cambia?
14 días. Acceso completo. Sin tarjeta de crédito. ¿Qué tienes que perder?
Emprendedores de toda Europa han reemplazado el caos administrativo con una sola plataforma que funciona de verdad. Únete hoy.
14 días de prueba gratuita • Sin comisiones — siempre • Cancela cuando quieras