La API de programación y búsqueda le permite recuperar resultados de búsqueda de sistemas externos, portales de búsqueda y directorios de forma segura y controlada.
## Requisitos previos
Para poder consultar los trayectos, se necesita
- Un token del titular de la cuenta
- La URL correspondiente
## Parámetros disponibles
Puede añadir los siguientes parámetros a la URL mediante GET:
- xml_token: El token que se recibe para el acceso
- fecha: La fecha en formato Unix timestamp a partir de la cual se deben recuperar los resultados
- hasta_fecha: La fecha en formato timestamp Unix hasta cuando se deben mostrar los resultados (máximo 1 mes)
- días_máx: Número de días mostrados (máximo 31 días)
- ID_región_línea: Opcional, para restringir a una región de línea específica
- Tipo_de_línea: Opcional, para restringir a un tipo de línea específico
- ID_línea: Opcional, sólo emite esta línea
- station_id: Opcional, sólo muestra resultados de esta estación de salida
- destination_id: Opcional, sólo muestra resultados de esta estación de destino
- recurso_id: Opcional, sólo muestra resultados con el recurso especificado
- person_id: Opcional, para identificar a la persona
- capacidad: Opcional, para mostrar la capacidad de conducción (costes de rendimiento)
## Resultado de la búsqueda
El resultado de la búsqueda se emite como JSON y se agrupa en las siguientes secciones:
- Información meta (meta): Fecha de creación
- Información del cliente (tiendas): Información sobre el cliente y la URL de destino
- Estaciones (stations): Estaciones disponibles
- Conexiones (relaciones): Combinaciones de trayectos con tipo de tarifa y operador de la línea
## Integración de la máscara de reserva
La URL de la máscara de reserva se muestra en el resultado de la búsqueda en la sección "tienda". Para cargar la máscara de reserva directamente con el resultado de búsqueda seleccionado, puede utilizar los siguientes parámetros opcionales:
- port_id: Estación de salida como valor int
- Destino_id: Estación de destino como valor int
- Id_línea: Restricción a una línea específica
- Fecha_llegada: Fecha del viaje de ida como timestamp Unix
- días_de_visualización: Número de vistas previas del resultado de la búsqueda en días
- viaje_único: true como cadena sólo para el viaje de ida
- Fecha_de_retorno: Fecha del viaje de vuelta como sello de tiempo Unix (opcional)
- agent_id: ID del destinatario de la comisión del portal de conexión
## Ejemplo de máscara de reserva