Saltearse al contenido

Cómo crear y utilizar un token de API

Los tokens de API permiten que otro sistema se conecte a su cuenta de TicketingHub. Debe tener acceso de administrador para gestionarlos.

¿Para qué puedo utilizar un token de API?

  • Enviar datos de TicketingHub a un software de generación de informes o a un almacén de datos.
  • Permitir que una plataforma de un socio personalizada lea productos y precios.
  • Crear una experiencia de reserva del lado del servidor que compruebe la disponibilidad en tiempo real.

Un token de API no crea una conexión integrada con Google Sheets. Consulte Cómo exportar datos de TicketingHub y conectar otras herramientas para elegir entre exportaciones CSV, Zapier, webhooks y acceso a la API.

Activar el acceso a la API

  1. Vaya a Configuración → Funciones.
  2. Active Acceso a la API.

Esta opción está disponible mediante autoservicio. Después de activarla, Tokens de API aparecerá en Configuración.

Crear un token

  1. Vaya a Configuración → Tokens de API.
  2. Seleccione Generar token de API.
  3. Introduzca un nombre que identifique el sistema que utilizará el token.
  4. Elija Supplier API (V2) para la gestión del proveedor, Widget API para la disponibilidad y las reservas, u OCTO API para conectar sistemas que utilicen el estándar OCTO.
  5. Si ha elegido Supplier API (V2) u OCTO API, puede seleccionar Solo lectura cuando la integración solo necesite consultar datos. Esta opción no se aplica a los tokens de Widget API.
  6. Añada una fecha de caducidad si es necesario y, a continuación, genere el token.
  7. Copie el token inmediatamente y guárdelo de forma segura. El token completo solo se muestra una vez.

Utilizar el token

Envíe el token en el encabezado Authorization de cada solicitud a la API:

Authorization: Bearer YOUR_TOKEN

Utilice los tokens de API únicamente en sistemas seguros del lado del servidor. No incluya un token en el código del sitio web, correos electrónicos, mensajes de chat ni documentos compartidos.

Revocar un token

Vaya a Configuración → Tokens de API y seleccione Revocar junto al token. La revocación se aplica inmediatamente, por lo que el sistema conectado dejará de funcionar hasta que utilice un token de sustitución.

Cree un token independiente para cada integración, utilice únicamente los permisos que necesite y revoque los tokens que ya no estén en uso. Para actualizaciones basadas en eventos, puede preferir los webhooks o la integración con Zapier.