# 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](/es/developers/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](/es/developers/badge).

## 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](/developers/openapi.json), con el evento bajo `webhooks`.
* [llms.txt](/llms.txt) enumera las páginas; [llms-full.txt](/llms-full.txt) reúne el contenido.
* Cada página tiene versión Markdown: [/es/developers/webhooks.md](/es/developers/webhooks.md). El índice está en [/es/developers/index.md](/es/developers/index.md).