Ir al contenido

Documentación técnica

Conecta StayParity con tus sistemas: webhooks firmados, el widget de reserva directa para la web del hotel y la comprobación de precios para chatbots.

StayParity te da tres piezas sobre las que construir: webhooks que avisan a tu servidor cuando una OTA vende más barato que un hotel, un widget que enseña a los clientes, en la web del propio hotel, que reservar directamente sale a cuenta, y una comprobación de precios que da a un chatbot o a tu propio widget la respuesta del widget.

Webhooks

StayParity envía cada nueva disparidad de precio a tu endpoint como JSON firmado: un vendedor de los resultados de búsqueda de hoteles que vende la misma habitación que el hotel, ambas asignadas a uno de los tipos de habitación del hotel, por menos que el precio de su web. Úsalo para abrir una incidencia, avisar al revenue manager o alimentar tus propios informes.

Las entregas siguen Standard Webhooks, así que una biblioteca estándar las verifica en pocas líneas. Consulta Webhooks para el evento, las firmas, los reintentos y las pruebas.

Widget de reserva directa

Una etiqueta <script> en la página de reservas del hotel muestra a los clientes el precio de la web junto a lo que cobran las OTAs, cuando el hotel es el más barato o iguala el mínimo. Si una OTA es más barata, el widget muestra solo el precio de la web.

Consulta la integración del widget para el código, sus opciones y lo que muestra, y Mide el widget en tu analítica para contar en GA4 las reservas que trae.

Comprobación de precios

Un GET con la clave del hotel devuelve en JSON la respuesta del widget para una noche: el precio de la web del hotel y, cuando es el más barato o iguala el mínimo, los precios de las OTAs junto a él. Úsalo para citar el precio de la web en un bot de WhatsApp, un asistente de chat o un widget propio. Consulta la API de comprobación de precios para la solicitud, las respuestas y un bot de ejemplo.

Claves

Los webhooks y el widget tienen cada uno su clave, y la comprobación de precios usa la del widget. Funcionan de forma distinta:

ClavePrefijoDónde¿Secreta?
Clave de firmawhsec_…Configuración → Webhooks, una por cuentaSí. Guárdala en tu servidor.
Clave del hotelwk_…Configuración → Widget de la web, una por hotel, para el widget y la comprobación de preciosNo. Está en el HTML público del hotel.

La clave de firma demuestra que un webhook viene de StayParity. Se muestra una sola vez, y solo los administradores de la cuenta pueden crearla o sustituirla.

La clave del hotel solo muestra el widget de ese hotel y responde a su comprobación de precios, y ninguno de los dos dice más de lo que cualquier cliente podría ver. Cualquiera puede copiarla del código fuente de la página. Si eso te importa, pulsa Sustituir código en el portal: genera otra clave y la anterior deja de funcionar. El navegador de un cliente puede seguir mostrando hasta cinco minutos un widget que ya había cargado.

No hay ninguna API para leer o cambiar los datos de la cuenta. Los webhooks envían eventos a tu servidor, y el widget y la comprobación de precios leen la misma comparación pública. Ninguno necesita un token de API.

Para herramientas y agentes

  • La comprobación de precios y el webhook en OpenAPI 3.1: la comprobación de precios en paths y el evento en webhooks.
  • Esta documentación en texto plano para modelos de lenguaje: llms.txt enumera las páginas y llms-full.txt reúne en un solo archivo las páginas en inglés.
  • Cada página en Markdown: añade .md a su dirección, como en /es/developers/webhooks.md. El índice está en /es/developers/index.md.

En esta página