Saltar al contenido
GuestMakerDesarrolladores
Vista generalDocumentaciónEventosSDKSandboxNovedades
EN/ES
Solicitar acceso
Vista generalDocumentaciónEventosSDKSandboxNovedades
Solicitar acceso
Volver a la documentación
Interactivo
Modo simulado

Sandbox de API

Explora las estructuras de solicitud y respuestas de ejemplo en modo simulado. Cambia al modo real para enviar solicitudes a la API de este sitio con tu propia clave. Las escrituras en modo real pueden modificar datos reales e iniciar recorridos. Sustituye los ID y los datos ficticios del hotel y del huésped antes de enviar.

76 solicitudes de ejemplo de 11 familias de API. Cada opción indica sus credenciales, permisos y requisitos. Los flujos de autenticación con varios pasos tienen sus propias guías más abajo.

Autenticación

Modo simulado activado

Las solicitudes devolverán respuestas de ejemplo sin realizar llamadas reales a la API. Los ejemplos son ilustrativos y no validan ni almacenan tu payload.

Endpoint
POST
/api/v1/reservations

Crea o actualiza por reservation_id. Una reserva nueva devuelve 201; una actualización devuelve 200. Pueden ejecutarse los journeys vinculados.

Permiso necesario: reservations:write. Referencia del endpoint

Cuerpo de la solicitud
Payload JSON. El modo simulado muestra una respuesta predefinida; el modo real aplica la validación del endpoint.
Respuesta
No se ha enviado ninguna solicitud

Ejecuta una solicitud para ver la respuesta

El modo simulado está activado: no requiere clave de API

Flujos de autenticación
Estos flujos usan redirecciones, credenciales del servidor o confirmación del huésped. Sigue la guía de integración para configurar todos los pasos.

Autorización OIDC e intercambio de tokens

Completa una redirección del navegador con client_id registrado, state, nonce y PKCE S256. Intercambia el código de un solo uso desde tu backend con las credenciales del cliente; los secretos del cliente deben permanecer en tu servidor.

GET /api/oidc/authPOST /api/oidc/tokenSeguir la guía de integración

Transferencia al club desde el motor de reservas

Intercambia un código real de un solo uso con X-Client-Id y X-Client-Secret en tu backend. Para consultar después al miembro se necesitan las credenciales del cliente y el token de transferencia. Una clave de la API principal no puede sustituirlos.

POST /api/loyalty/club/exchangeGET /api/loyalty/club/meSeguir la guía de integración

Confirmación de suscripción al boletín por email

El huésped abre el enlace firmado enviado a su email. GET muestra el botón de confirmación; el POST del huésped confirma la suscripción. Usa este flujo HTML de dos pasos en lugar de tratar el enlace firmado como una consulta JSON.

GET /api/public/newsletter/confirmPOST /api/public/newsletter/confirmSeguir la guía de integración
Consejos

• Modo simulado te permite explorar la API sin credenciales

• Los números de teléfono deben tener formato E.164 (p. ej., +1234567890)

• Usa idempotency_key para evitar que un evento se procese dos veces

• Ante un HTTP 429, respeta Retry-After. Los límites dependen de tu clave y del endpoint.

• Los eventos aceptados devuelven 202. Pueden ejecutarse los recorridos activos que coincidan.

• El historial de solicitudes y la clave introducida se conservan en la memoria de esta página. Los ejemplos copiados usan una variable de entorno.

GuestMaker

El CRM con IA omnicanal
para grupos hoteleros.

● de Hotelinking ↗
DESARROLLARInicio rápidoReferencia de la APIAutenticaciónWebhooksSandbox de API
EXPLORAREventos webSDK y bibliotecasFidelización y SSOCrédito monetarioNovedades
CONECTARSolicitar acceso a la APIPlataforma GuestMakerIntegraciones
© 2026 GuestMaker · Hotelinking, S.L.Palma de Mallorca, España
PrivacidadCondicionesAviso legal