Direkte svar: Fleet OS er den software, som Cityflow driver sin egen flåde med, og dens API har 46 REST-endpoints med Bearer-godkendelse og en test-sandbox. Et hotels PMS, en bygnings app eller dit ERP kan oprette bookinger, registrere udlevering og aflevering af cyklen, slå flåden op og læse nøgletal.
Denne artikel er til operatører med egen flåde. Har du et hotel og vil bare have cykler til dine gæster, er der intet at integrere: på de hoteller, Cityflow driver, låser gæsten cyklen op med sit værelses NFC-nøglekort. Du finder det under elcykler til hoteller.
Hvad er der præcist i Fleet OS' API?
Der er 46 endpoints i seks grupper. Alle kaldes med POST, med body i JSON og nøglen i headeren »Authorization: Bearer«. Parametrene og eksemplerne finder du i API-referencen.
| Gruppe | Endpoints | Til hvad |
|---|---|---|
| Bookinger og turisme (7) | /create_advance_booking, /get_booking, /cancel_booking, /rental_checkin, /rental_checkout, /purchase_tourist_pass, /validate_tourist_pass | Booke, udlevere med oplåsningskode, aflevere med afregning, pas |
| Urban mikromobilitet (3) | /get_vehicles_status, /get_operating_zones, /calculate_trip_fare | Flådens status, en bys zoner, prisen for en tur |
| Firmaflåder (3) | /register_corporate_user, /set_employee_permissions, /create_campus_reservation | Oprettelse efter maildomæne, rettigheder, bookinger på et campus |
| Flere byer og franchises (2) | /get_master_overview, /get_franchise_metrics | Overblik over netværket, nøgletal pr. franchise eller ejendom |
| Intern administration (4) | /create_hotel, /set_hotel_prices, /create_bike, /update_bike_status | Oprettelser, priser pr. hotel, hver cykels status |
| Tabeller (27) | /update_booking, /update_payment, /update_maintenance og 24 mere | Ændre en post felt for felt |
De 27 tabel-endpoints fungerer ens: du sender record_id og kun de felter, der ændres.
Hvordan foregår godkendelsen, og hvordan tester man uden risiko?
Med en API-nøgle, som Cityflow udleverer, når du tegner Fleet OS; uden den returnerer platformen ingen data. Fra første dag har du en sandbox med testdata, så du kan validere integrationen uden at røre rigtige cykler.
Sandboxens svar angiver det i feltet meta, og mangler en obligatorisk parameter, siger fejlen hvilken.
Hvordan kobles et hotels PMS på?
Ved at kalde endpoints for bookinger fra PMS'et eller fra en lille mellemliggende udvikling. Et muligt flow:
- Gæsten tilføjer cyklen til sit ophold: /create_advance_booking med gæstens mail, ejendommen, datoerne og cyklerne.
- Hvis gæsten annullerer opholdet: /cancel_booking.
- Ved ankomst: /rental_checkin, som returnerer oplåsningskoden, så den kan vises for gæsten.
- Til sidst: /rental_checkout, som afslutter lejen med afregningen.
- Når som helst giver /get_booking bookingens status.
Fleet OS skriver ikke i PMS'et: for at føre beløbet på værelsesregningen sender din udvikling afregningen til PMS'et med PMS'ets eget API, eller Cityflow bygger det som en separat integration.
Og en bygnings eller en virksomheds app?
Med de samme endpoints. Appen i en bygning, du servicerer, viser de ledige cykler med /get_vehicles_status, og med /create_advance_booking og /rental_checkin booker beboeren og får sin kode uden at forlade appen.
Til en virksomheds flåde kan intranettet:
- oprette hver medarbejder med /register_corporate_user, som validerer maildomænet;
- tildele rettigheder pr. afdeling eller profil med /set_employee_permissions;
- booke på campus med /create_campus_reservation.
Hvad kan et ERP eller et internt system læse og skrive?
Det kan læse nøgletal og skrive flådens status. /get_master_overview giver overblikket over hele dit netværk i en periode, og /get_franchise_metrics deler det op pr. franchise eller pr. ejendom. Mere i hvordan du styrer flere flåder fra ét panel.
Dit værkstedssystem kan sætte en cykel til vedligehold, og tilbage til ledig, med /update_bike_status. Nye cykler oprettes med /create_bike med model, ejendom og låsetype. Fleet OS er kompatibelt med låse fra Linka, AXA IN og Omni og med IoT fra Acton og Okai: du finder det i guiden til smartlåse og IoT.
Tabellerne dækker blandt andet bookinger, betalinger, vedligehold, hændelser og brugere.
Hvad er ikke i API'et?
Der mangler tre ting, som det er godt at vide, før du designer integrationen:
- Automatiske notifikationer (webhooks). API'et giver ikke besked, når en leje starter eller slutter: dit system spørger med /get_booking eller /get_vehicles_status.
- Færdige connectorer til et bestemt PMS. Dem bygger dit team eller Cityflow.
- Skrivning i dine systemer. Fleet OS svarer på dine kald; det skriver ikke på egen hånd i dit PMS eller dit ERP.
Hver af dem prissættes som en integration: 750 € for en standardintegration; de øvrige med et tilbud.
Hvad koster det at bruge API'et?
Intet ekstra: adgangen er inkluderet i Fleet OS-abonnementet, som er 300 € om måneden plus fra 8 € til 3 € pr. køretøj afhængigt af trinnet, med 1.000 € i aktivering og uden binding. Det eneste, der betales separat, er integrationer med hardware eller systemer, som Fleet OS ikke har som standard, 750 € for en standardintegration. Detaljerne finder du under priserne på Fleet OS.
Hvordan kommer vi i gang?
- Læs API-referencen, og markér de endpoints, der passer til din case.
- Bed om en demo, og fortæl Cityflow, hvilke systemer du vil koble på.
- Når aftalen er på plads, får du nøglen og sandboxen, og dit team validerer integrationen.
Fleet OS er den software, som Cityflow driver sin flåde med i 9 provinser, og der er operatører i branchen, der allerede kører med den. Mere på siden om Fleet OS, hvor du også kan bede om en demo.
Ofte stillede spørgsmål
Hvor mange endpoints har Fleet OS' API?
46 REST-endpoints med Bearer-godkendelse og en sandbox med testdata, fordelt på seks grupper; 27 af dem bruges til at ændre tabellerne felt for felt. Den fulde reference er offentliggjort på cityflow.app/software/api.
Kan Fleet OS kobles til et hotels PMS?
Ja: PMS'et, eller en mellemliggende udvikling, kalder endpoints for bookinger for at oprette bookingen, registrere udleveringen med oplåsningskoden, afslutte lejen med afregningen eller annullere den. Fleet OS har ikke en færdig connector til et bestemt PMS: bygger Cityflow den, er det en separat integration, 750 € for en standardintegration.
Giver Fleet OS' API besked til mit system, når en leje starter eller slutter?
Nej: referencen indeholder ikke automatiske notifikationer (webhooks). Dit system spørger efter status med /get_booking eller /get_vehicles_status; har du brug for, at Fleet OS giver besked, prissættes det som en integration.
Hvad koster adgangen til Fleet OS' API?
Den er inkluderet i Fleet OS-abonnementet: 300 € om måneden plus fra 8 € til 3 € pr. køretøj afhængigt af trinnet og 1.000 € i aktivering, uden binding. Integrationer med hardware eller systemer, som Fleet OS ikke har som standard, koster 750 € for en standardintegration.
Kan jeg teste integrationen uden at røre min rigtige flåde?
Ja. Fra første dag har du en sandbox med testdata, og svarene angiver det i feltet meta. Dit team validerer hvert trin, før det kobles til de rigtige cykler.
NÆSTE SKRIDT
Vil du have et skræddersyet tilbud til din drift?
Fortæl os, hvad du har brug for, og vi vender tilbage inden for 24 timer med en plan tilpasset din forretning.
Tal med salg
