Shotl API
Encaixa amb el teu ecosistema de mobilitat
Connecta els serveis de Shotl amb apps de MaaS, planificadors de trajectes i BI, amb API segures i documentades.
{
"pickup": [41.49, 2.14],
"dropoff": "rail-hub-04",
"passengers": 2,
"wheelchair": false,
"requested_time": "now"
}
→ 201 Created
{
"booking_id": "bk_8f31",
"vehicle": "SHTL-07",
"eta_minutes": 6
}Sol·licitud il·lustrativa: la documentació completa de l’API es comparteix durant la incorporació.
Ja connectats
El teu servei, reservable dins d’altres apps
LINEA Tainan, els passatgers reserven dins de l’app de missatgeria que ja fan servir: sense descàrregues ni comptesLlegeix el casAmb la Shotl API, els passatgers poden reservar els mateixos viatges des d’una app de MaaS o d’una app de missatgeria que ja fan servir, amb els mateixos vehicles, regles i dades al darrere. A Tainan, aquesta app és LINE.
- myBuxiSuïssaServeis de Shotl connectats a myBuxi i al seu projecte de mobilitat KIM.Llegeix-ne més →
- HiTransHighlands escocesesViatges a demanda reservats al costat d’autobusos, trens i transbordadors arreu de la regió.Llegeix el cas →
Mobilitat autònoma
Vehicles autònoms, assignats com la resta de la teva flota
Les llançadores autònomes es connecten a la plataforma amb les mateixes API que qualsevol altre vehicle. Els passatgers les reserven a la mateixa app, i la sala de control les veu al mateix tauler.
- API a mida per al vehicle. Creades per intercanviar informació entre la plataforma de Shotl i el bus autònom.
- Fix o a demanda. Un circuit programat a les hores punta, amb recollides a petició quan el circuit es buida.
- Amb la marca del mateix pilot. L’app del passatger publicada com a servei de marca blanca.
Integrat a l’API
Connecta el servei amb tot el que l’envolta
Els planificadors de trajectes, les apps de MaaS i els teus propis sistemes es connecten amb les mateixes API documentades.
- A tots els planificadors de trajectesLa integració GTFS situa el servei al costat dels trens i els tramvies als planificadors que els passatgers ja fan servir.
- Dins de les apps de la teva regióEls passatgers poden reservar des d’apps regionals de MaaS o de missatgeria: a Tainan reserven dins de LINE.
- Llegeix dels teus propis sistemesConductors, vehicles, parades, zones i plans de servei poden venir de les teves API en lloc de mantenir-se per duplicat.
- Les teves dades, a foraUna API de consulta exposa reserves, KPI i posicions dels vehicles en temps real, i les dades d’activitat se’t lliuren.Operations Dashboard
- Tarifes i pagaments, integratsPagaments amb targeta al teu propi compte de Stripe, pagament a bord i un preu per tipus de tarifa.Tarifes i pagaments
- Unitats embarcades, si en tensEl bus CAN o altres unitats embarcades poden aportar un seguiment més ric. Només cal el telèfon o la tauleta del conductor.
Preguntes freqüents
Les preguntes que més ens fan
Els passatgers poden reservar des d’una app que no és nostra?
Sí. A Tainan (Taiwan), els passatgers reserven viatges de Shotl dins de LINE —l’app de missatgeria que ja fan servir cada dia— sense cap descàrrega addicional. El mateix enfocament funciona per a apps regionals de MaaS i planificadors de trajectes.
L’API està documentada públicament?
Sí: documentació versionada amb exemples, perquè el teu equip o proveïdor pugui definir l’abast d’una integració abans de parlar amb nosaltres.
Shotl publica GTFS?
Sí: GTFS d’entrada i de sortida, incloses les zones a demanda, a més de posicions dels vehicles en directe i avisos del servei.
Quant dura una integració de MaaS?
Unes dues setmanes és el més habitual per a la reserva i el seguiment des d’una app regional de MaaS.
Com es protegeix l’accés?
Claus d’API basades en rols, infraestructura allotjada a la UE i registres d’auditoria: respostes que el teu equip de contractació pot copiar i enganxar.
Es poden connectar flotes de tercers?
Sí: les flotes externes i autònomes s’assignen amb les mateixes API que els teus vehicles.
Del blog
