Saltar al contenido
Task, Channels and Partner API

API para socios: gestionar claves y webhooks

Con la API para socios conectas tus propias páginas de reservas, apps e integraciones con STRYK. Creas claves con exactamente los permisos necesarios y configuras webhooks.

Last updated: Owner, Developers
Contents
  1. Antes de empezar
  2. Abrir la API
  3. Crear clave API
  4. Gestionar claves
  5. Configurar webhooks
  6. Gestionar webhooks
  7. Comprobar el resultado
  8. Si algo no funciona
  9. Relacionado con esto

Antes de empezar

  • Necesitas el permiso Administrar canales. Solo así ves la fila API en la página Canales.
  • Aclara qué áreas debe leer o escribir la integración. Una clave solo recibe esos permisos.
  • Una integración llama a la API para socios desde su servidor. La clave nunca la guardas en código de navegador ni en una app. Los endpoints, parámetros y ejemplos están en la Documentación para desarrolladores. Allí, la sección Autenticación y alcances explica qué permite cada permiso.
  • Los webhooks necesitan un destino con una dirección que empiece por https://.

Abrir la API

In STRYKCanales

  1. Elige en Conexiones propias la fila API con el texto „Claves API y webhooks“. Se abre el diálogo API.
  2. Elige la pestaña Claves API o Webhooks. Con Documentación para desarrolladores en la cabecera del diálogo abres el portal para desarrolladores.
  1. Pestañas Claves API y Webhooks
  2. Clave con permisos
  3. Acciones de la clave

Crear clave API

In STRYKCanalesAPIClaves API

  1. Elige Crear clave API. Se abre el diálogo Crear clave API.
  2. Escribe el Nombre, por ejemplo „Página de reservas“.
  3. Elige en Permisos un patrón: Solo lectura (leer todas las áreas), Lectura y escritura (escribir donde sea posible) o Personalizado. Con Personalizado eliges para cada área Sin acceso, Leer o Escribir. Las áreas son Hotel y habitaciones, Disponibilidad, Precios y tarifas, Reservas, Huéspedes, Pagos y Facturas. Escribir incluye Leer. Las facturas son documentos fiscales del hotel y solo se pueden leer por API.
  4. Opcional: abre Avanzado. Elige la Caducidad: Sin caducidad, 30 días, 90 días, 1 año o Fecha (desde mañana, como máximo dentro de tres años). En Restricción de IP introduce en cada línea una dirección o una red CIDR, como máximo 20. Vacío permite todas las direcciones. En Nota anotas un aviso interno.
  5. Elige Crear. STRYK muestra Clave API creada con la clave y la indicación Visible solo ahora.
  6. Copia la clave y guárdala, por ejemplo, en tu gestor de contraseñas. Elige Hecho.

Gestionar claves

In STRYKCanalesAPIClaves API

La lista muestra por cada clave Nombre, el inicio de la clave, los Permisos, Creado, Último usado, Caducidad y el estado: Activo, Caduca pronto, Revocado o Caducado. Elige una clave para ver Permisos, Caducidad, Direcciones IP permitidas, Límite de solicitudes (solicitudes por minuto), Uso, Solicitudes recientes y el Historial.

  1. Abre en la fila el menú Opciones.
  2. Elige Regenerar si la integración debe recibir una clave nueva con los mismos permisos. En Clave actual elige Clave antigua válida 24 h más, para poder cambiar la integración, o Revocar de inmediato. Confirma con Regenerar. STRYK muestra la clave nueva una sola vez.
  3. Elige Revocar y confirma ¿Revocar la clave API? para bloquear una clave de inmediato. STRYK entonces rechaza las solicitudes con esa clave.

Configurar webhooks

In STRYKCanalesAPIWebhooks

Un webhook envía los eventos elegidos firmados por HTTPS a tus sistemas.

  1. Elige Crear webhook. Se abre el diálogo Nuevo webhook.
  2. Introduce la URL de destino, por ejemplo https://crm.nordlicht.invalid/hooks/stryk. La dirección debe empezar por https://.
  3. Opcional: escribe una Descripción, por ejemplo „Reservas a nuestro CRM“.
  4. En Eventos, elige al menos uno: Reserva creada, Reserva modificada, Reserva cancelada, Huésped modificado, Disponibilidad modificada, Precio modificado, Pago modificado o Estado de habitación cambiado. Con Seleccionar todo y Deseleccionar eliges todos o ninguno.
  5. Elige Crear webhook. STRYK muestra Tu secreto de firma una sola vez.
  6. Guarda el secreto en tu receptor. Cómo el receptor verifica la firma lo describe la documentación para desarrolladores en Webhooks y verificación de firma.
  7. Elige el webhook y después Enviar evento de prueba. STRYK indica „El evento de prueba se está entregando.“

Gestionar webhooks

Ort: Canales > API > Webhooks, elige el webhook

  • Con el interruptor Entrega activa pausas o activas el webhook. Los webhooks pausados no reciben eventos. Tras activarlo, la entrega empieza con eventos nuevos.
  • Últimos 7 días, Último éxito y Último error muestran el estado. En Entregas ves cada entrega con Estado HTTP e Intentos. Con Enviar de nuevo repites una entrega.
  • Renovar secreto genera un secreto nuevo. El anterior sigue válido 24 horas, para que puedas cambiar el receptor.
  • Con Editar cambias la dirección y los eventos; con Eliminar y la confirmación ¿Eliminar el webhook? lo quitas. El registro de entregas se conserva 30 días.

Comprobar el resultado

  • En la clave aparece Último usado con fecha en cuanto la integración la utiliza. Solicitudes 24 h cuenta las solicitudes.
  • En el webhook, Últimos 7 días muestra „{Zahl} entregados, {Zahl} fallidos“, y el evento de prueba aparece en Entregas.

Si algo no funciona

Lo que vesCausaCómo lo solucionas
„Elige al menos un permiso.“Ningún área tiene un permiso.Elige un patrón o asigna a al menos un área Leer o Escribir.
„Introduce un nombre.“Falta el Nombre.Escribe un nombre.
„Revisa:“ seguido de una direcciónUna dirección de Restricción de IP no es válida.Corrige la dirección o la red CIDR. Se permiten como máximo 20 entradas.
„Elige una fecha desde mañana, como máximo dentro de tres años.“La fecha de caducidad está fuera del período.Elige una fecha desde mañana que esté como máximo a tres años vista.
„La dirección debe empezar por https://.“La URL de destino no es una dirección HTTPS.Escribe una dirección que empiece por https://.
„Elige al menos un evento.“El webhook no tiene ningún evento.Elige al menos uno en Eventos.
En pausa por errores repetidosEl receptor no responde con un estado 2xx.Comprueba que el receptor esté accesible y elige Reactivar.
„Activa el webhook para enviar un evento de prueba.“El webhook está pausado.Activa Entrega activa y envía el evento de prueba.
„No se pudo cargar la selección. Cierra y vuelve a abrir.“La lista de permisos y eventos no se ha cargado.Cierra el diálogo y vuelve a abrirlo.
Contacto