Shared mobility
The shared mobility API provides functionality for booking a shared mobility trip and making transport operators' shared mobility products available for sale.
The app serves as an API layer between clients who wish to offer trips with shared mobility through their channels and transport operators who provide these products. The API facilitates bookings of products through transport operators' APIs that support the TOMP standard. All communication with transport operators is based on the TOMP (Transport Operator MaaS Provider) API standard, ensuring a standardized and scalable integration model.
+## How it works
- +From a high-level perspective, the solution is divided into three main roles:
- +- Client applications (for example, public transport authority apps) that present shared mobility options to end users +- Entur Shared Mobility services, which handle booking logic, pricing, payment, and orchestration +- Transport operators, who provide the actual shared mobility assets and expose TOMP-compliant APIs
- +Entur’s platform ensures that client applications do not need to integrate directly with each individual operator. Instead, Entur provides a unified API and takes responsibility for routing, protocol translation, and lifecycle management of shared mobility trips.
Services
shared-mobility, shared-mobility-to-ref, shared-mobility-router
| Service | Description |
|---|---|
| shared-mobility | This is the main application for the shared mobility team, which facilitates the sale of products from transport operators that support the TOMP API standard. It includes functionality for clients to start, pause, and end a trip with a shared mobility product and has full integration with Entur's sales platform for creating orders, processing payments, sending receipts to travelers, and handling settlements. |
| shared-mobility-router | Acts as a translation and routing layer, handling all TOMP communication between Entur and transport operators. |
| shared-mobility-to-ref | Reference application for transport operators for how to implement the TOMP API standard |
Guides
| Guide | Description |
|---|---|
| Client guide | Guide for how to sell shared mobility through the shared-mobility API |
| Transport operator guide | Guide for how to support the TOMP API standard and make products available for sale |
Sequence diagram
