La versión francesa de este artículo se ha actualizado desde su traducción. Leer la versión francesa
Conecte su herramienta mediante la API
¿Su software no está en la lista? Genere un token de importación y haga que su propia herramienta envíe sus alojamientos, sus reservas y sus servicios, con la fuente personalizada.
El vídeo de esta guía llegará pronto.
La fuente personalizada (API) alimenta The Big One desde cualquier herramienta: su software propio, una hoja de cálculo automatizada, una herramienta que no conocemos. Su herramienta envía alojamientos, reservas, servicios y nombres de planificación con una simple petición. Este artículo le muestra qué preparar y qué transmitir a la persona que hará la conexión. Calcule 5 minutos por su parte.
¿Su software aparece en la página Integraciones? Mejor vincúlelo sin desarrollo: Conecte su software de gestión.
Qué sincroniza la conexión
| Dato | Sentido | Observación |
|---|---|---|
| Alojamientos | De su herramienta a The Big One | Un alojamiento ausente de un envío nunca se elimina |
| Reservas | De su herramienta a The Big One | Se cancelan solo si su herramienta declara un periodo completo |
| Servicios | De su herramienta a The Big One | Un servicio empezado, terminado o validado nunca se sobrescribe |
| Nombres de planificación | De su herramienta a The Big One | Se asocian a las cuentas existentes; no se crea ninguna cuenta |
Antes de empezar
- Usted es administrador: la página Integraciones está reservada al administrador.
- Una persona sabe escribir un pequeño programa que envía datos: su desarrollador, o el proveedor de su herramienta.
- Cada alojamiento, reserva y servicio de su herramienta tiene un identificador que no cambia. Sirve para no crear ningún duplicado.
Generar el token de importación
Paso a paso
- 1
Abra Configuración › Flujos e integraciones › Integraciones.
- 2
En la parte superior de la página, haga clic en el filtro «Desarrolladores». Allí está la tarjeta «Fuente personalizada (API)».
- 3
Haga clic en Generar un token. Se abre la ventana «Su token de importación».
- 4
Haga clic en Copiar el token. Aparece el mensaje «Token copiado.».
- 5
Guarde el token en un lugar seguro y cierre la ventana. La tarjeta lleva la mención «Token activo».
Transmitir la información a su desarrollador
Paso a paso
- 1
En la tarjeta, junto a «Dirección de envío:», haga clic en Copiar. Aparece el mensaje «Dirección copiada.».
- 2
Haga clic en Ver la documentación. La página describe la dirección, las cabeceras, un ejemplo completo, las reglas de importación y los límites.
- 3
Envíe a su desarrollador la dirección de envío, el enlace de la documentación y, por un canal seguro, el token.
Las reglas que hay que conocer antes de escribir el programa:
| Regla | Lo que significa |
|---|---|
| Un identificador por elemento | Cada elemento se reconoce por su identificador: enviar de nuevo el mismo contenido no crea ningún duplicado |
| Alojamiento ausente de un envío | Nunca se elimina: solo cuenta el valor «activo» enviado |
| Lencería del alojamiento | En cada envío, la parte de lencería de la ficha se sustituye entera: lo escrito a mano se sobrescribe |
| Servicio ya empezado | Nunca se sobrescribe: solo se completan sus campos vacíos |
Comprobar las importaciones
Paso a paso
- 1
En la tarjeta «Fuente personalizada (API)», lea la línea «Última importación:». Da la fecha del último envío recibido.
- 2
Despliegue «Últimas 30 importaciones». Cada línea cuenta, por tipo de dato, los elementos creados, actualizados y conservados.
- 3
¿Una línea indica errores? Despliéguela para leer el detalle y transmítalo a su desarrollador.
Revocar el token
Se hace si el token ha circulado, o cuando cambia de herramienta.
Paso a paso
- 1
En la tarjeta, haga clic en Revocar. Se abre la ventana «¿Revocar el token?».
- 2
Haga clic en Revocar el token. Aparece el mensaje «Token revocado: las próximas llamadas se rechazarán.».
- 3
Para volver a conectar su herramienta, haga clic de nuevo en Generar un token y dé el nuevo token a su desarrollador.
Preguntas frecuentes
¿Hace falta un desarrollador?
Sí. La fuente personalizada espera datos enviados por un programa. Sin desarrollador, vincule un software de la página Integraciones o un enlace iCal.
¿Un alojamiento importado por la API puede vincularse a un anuncio de otra integración?
No. Su herramienta lo encuentra por su identificador en cada envío: no puede vincularse a un anuncio de otra integración.
¿Mi herramienta puede recibir un aviso cuando un servicio termina?
Sí. En el filtro «Desarrolladores», la tarjeta «Acceso para desarrolladores» permite añadir una dirección a la que avisar cuando un servicio se asigna, empieza, termina o se valida.
¿Qué pasa si genero un nuevo token?
El anterior queda revocado: los envíos que lo usan se rechazan. Dé el nuevo token a su desarrollador.
¿La importación crea las cuentas de los limpiadores?
No. Una importación no crea ninguna cuenta: los nombres sin correspondencia se devuelven a su herramienta para que usted invite a la persona.