API de Shotl
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 viatgers reserven dins de l’app de missatgeria que ja fan servir: sense descàrregues ni comptesLlegir el casAmb l’API de Shotl, els viatgers 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 l’article →
- HITRANSHighlands escocesesEls viatges a la demanda es podien reservar al costat d’autobusos, trens i transbordadors arreu de la regió.Llegir 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 viatgers les reserven a la mateixa app, i el centre 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 la 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 per als viatgers 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 viatgers ja fan servir.
- Dins de les apps de la teva regióEls viatgers 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.Tauler d’operacions
- 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 viatgers poden reservar des d’una app que no és nostra?
Sí. A Tainan (Taiwan), els viatgers 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 funciona amb GTFS?
Sí. Les teves línies fixes es carreguen a la plataforma des de GTFS, per a les actualitzacions estàtiques i en directe del servei. La posició dels vehicles en temps real està disponible a través de l’API de consulta.
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
