L'errore delle bici «isolate»
Immagina un hotel con 8 bici CityFlow nella lobby. Funzionano, ma ogni volta che un ospite vuole usarne una deve andare in reception a chiedere il QR. La reception annota a mano. Zero dati. Zero integrazione. È lo scenario che NON vuoi.
Cosa cambia con un'API collegata
Quando CityFlow si integra via API con il PMS del tuo hotel (Mews, Cloudbeds, Apaleo, Opera) o con l'app del tuo edificio:
- L'ospite prenota la bici dall'app dell'hotel (senza scaricarne un'altra).
- L'addebito va dritto sul suo conto dell'hotel.
- I dati d'uso confluiscono nel tuo CRM (sai quali ospiti usano di più le bici).
- Il branding è al 100% dell'hotel.
Quel piccolo cambiamento trasforma la bici da "un'amenity qualsiasi" a "un servizio premium integrato".
API CityFlow — le capacità chiave
1. Provisioning degli utenti
Crea/elimina utenti dal tuo sistema. Quando fai il check-in di un ospite nel PMS, l'utente CityFlow si crea in automatico.
2. Dati dei viaggi
Ricevi un webhook quando un ospite inizia/termina un viaggio. Utile per fatturazione, CRM e reporting ESG.
3. Stato della flotta
Consulta in tempo reale quali bici sono disponibili, in uso o in manutenzione.
4. Prezzi dinamici
Applica tariffe diverse per tipo di ospite (VIP, abituale, suite premium).
5. Branding
Configura l'app integrata con i colori/il logo del tuo hotel.
Esempi di integrazione
Hotel boutique a Barcellona
Integrazione Mews + CityFlow. L'ospite prenota dall'app dell'hotel, l'addebito va sul conto, la reception ha piena visibilità. L'adozione della bici è passata dal 18% al 47% dopo l'integrazione.
Edificio Be Casa, Madrid
Integrazione con l'app interna dell'edificio. L'inquilino ha la bici "lì a portata" senza scaricare un'altra app. NPS del servizio bici: 9,1.
Operatore di bike sharing a Siviglia
Fleet OS + Stripe + integrazione con il sistema comunale di validazione dell'identità. Lanciato in 60 giorni.
Com'è lavorare con la nostra API
- REST + Webhook: uno standard moderno, facile da integrare.
- Documentazione pubblica: Swagger/OpenAPI su docs.cityflow.app.
- Sandbox: un ambiente di test dove il tuo team dev sperimenta senza toccare la produzione.
- Supporto tecnico: un ingegnere CityFlow assegnato durante l'integrazione.
Conclusione
Le bici da sole sono un'amenity. Le bici integrate con i tuoi sistemi interni sono un vantaggio competitivo misurabile. CityFlow è uno dei pochi operatori B2B con un'API vera e aperta. Se fai sul serio, integrare è la strada.
Vuoi vedere l'API o un caso di integrazione? Parla con un commerciale.
PROSSIMO PASSO
Vuoi una proposta su misura per la tua operazione?
Raccontaci di cosa hai bisogno e ti rispondiamo entro 24 ore con un piano adattato al tuo business.
Parla con il commerciale



