Documentación técnica
Integre StayParity con sus sistemas mediante webhooks firmados y añada el widget de reserva directa a la web del hotel. Claves, eventos y ejemplos.
StayParity ofrece webhooks para avisar a su servidor de nuevas discrepancias y un widget para mostrar el precio directo en la web del hotel.
Webhooks
Cuando una revisión detecta un precio OTA inferior al directo y cumple los criterios de aviso, enviamos un evento JSON firmado a su endpoint. Puede utilizarlo para crear una tarea o alimentar sus informes.
La firma sigue Standard Webhooks. Consulte Webhooks para conocer el formato, la verificación, los reintentos y las pruebas.
Widget de reserva directa
Una etiqueta <script> añade el precio directo a la página de reservas. Muestra precios OTA cuando el hotel es el más barato o iguala el mínimo; si alguna OTA es más barata, muestra solo el precio directo, sin afirmar que sea el mejor.
Consulte la integración del widget.
Claves
| Clave | Prefijo | Ubicación en la aplicación | ¿Secreta? |
|---|---|---|---|
| Firma | whsec_… | Settings → Webhooks, una por cuenta | Sí. Guárdela en el servidor. |
| Integración | wk_… | Settings → Website badge, una por hotel | No. Aparece en el HTML público. |
Solo los administradores pueden crear o sustituir la clave de firma. Se muestra una vez y permite verificar el origen del webhook.
La clave de integración permite mostrar la comparación pública del hotel. Cualquier visitante puede copiarla. Replace snippet genera otra clave; la anterior deja de funcionar en la siguiente solicitud sin caché. El widget almacenado en el navegador puede seguir visible hasta cinco minutos.
Todavía no existe una API pública para consultar o modificar datos de cuenta. Los webhooks envían eventos a su servidor y el widget consulta su comparación pública. Ninguno requiere un token de API.
Formatos para herramientas
- Contrato OpenAPI 3.1, con el evento bajo
webhooks. - llms.txt enumera las páginas; llms-full.txt reúne el contenido.
- Cada página tiene versión Markdown: /es/developers/webhooks.md. El índice está en /es/developers/index.md.