Para qué sirve la API
La API es una alternativa a los widgets para construir su presencia de venta en línea. Mientras que los widgets son módulos listos para usar que se integran, la API le permite construir su propio sitio web recuperando directamente los datos de Tourbiz: catálogo, disponibilidades, reservas.
La principal ventaja es obtener un sitio totalmente controlado en su diseño y su recorrido de usuario, sin depender de la apariencia de los widgets. Es la herramienta adecuada para los tour operadores y marketplaces que desean automatizar sus flujos con uno o varios socios.
La clave API
La gestión de la API se basa en una clave de autenticación. Desde el menú Venta en línea › API, se genera una clave y se muestra en la parte superior de la página (con el formato tourbiztest_…).
Esta clave se utiliza de dos formas:
- En la documentación Swagger, mediante el botón Authorize
- En las cabeceras HTTP de sus solicitudes
La documentación y los endpoints
La documentación completa está disponible en la dirección:
<https://www.tourbiz.net/api/v2/doc#/>
Se presenta en formato Swagger y agrupa los endpoints en tres familias:
| Familia | Contenido |
|---|---|
| Supplier | Información del proveedor |
| Products | Lista de productos, ficha de producto, disponibilidad, calendario |
| Bookings | Creación, confirmación, cancelación, consulta y actualización de las reservas |
Construir la URL de una llamada
La URL base de las llamadas se obtiene eliminando /doc#/ de la dirección de la documentación:
<https://www.tourbiz.net/api/v2/>
A continuación se añade la ruta de cada endpoint, por ejemplo /products o /availability.
Marcar los productos accesibles por la API
En la página API, una sección lista los productos disponibles y permite añadirlos, clasificados por proveedor, mediante una simple casilla de verificación.
⚠️ Punto importante: los widgets de reserva también se apoyan en la API. Por tanto, debe marcar sus productos en la pestaña API de Venta en línea antes de poder seleccionarlos en los widgets. Este paso condiciona los dos modos de difusión.
Esta selección también permite evitar exponer a través de la API productos de back-office no destinados a la venta en línea, como las privatizaciones.
Los contenidos expuestos: Textos API e Imágenes API
La API también expone contenidos enriquecidos para alimentar su sitio personalizado. Estos contenidos se indican en la ficha de producto, en modo edición, mediante dos pestañas dedicadas.
Textos API
En la pestaña Textos, una sección Textos API (distinta de los textos de producto estándar) agrupa:
- Título del feed
- Descripción corta del feed
- Contenido incluido / no incluido
Estos campos se pueden gestionar por idioma de traducción.
Imágenes API
En la pestaña Imágenes, una sección Imágenes API es distinta de la imagen de producto estándar.
Estos contenidos son, por tanto, independientes de los utilizados en otras partes del back-office.
