Dispatch fleets with Cab Booking API
Connect your platforms to a real-time ride hailing engine. Query available cabs, track driver locations via GPS telemetry, calculate dynamic trip fares, and automate driver dispatch workflows.
Cab API Router
● Online (v2.0)POST /api/v2/rides/request HTTP/1.1
Host: console.devsecit.com
Authorization: Bearer DSI_CAB_...
Content-Type: application/json
// Request Payload
{
"pickup": { "lat": 22.5726, "lng": 88.3639 }
"drop": { "lat": 22.6547, "lng": 88.4467 }
"vehicle_type": "sedan"
}
1. Platform Overview & Business Architecture
The Cab Booking API is a high-performance fleet dispatch and ride-hailing gateway. Building matching engines, routing scripts, ETA calculators, and live tracking channels for a modern transportation business is a significant infrastructure burden. This API solves this by offering a standardized, real-time middleware layer that coordinates driver availability, GPS data, trip fares, and payment options.
Using our API, developers can query available vehicles in a specific area; request on-demand rides; calculate trip distances and traffic-aware ETAs; assign trips to nearby drivers; and track vehicles via real-time WebSocket connection points.
Security is critical for mobility platforms. The API utilizes cryptographically signed request tokens and HTTPS/TLS 1.3 encryption to protect user locations, contact numbers, and payment details in compliance with data privacy regulations.
2. Cab Booking Features
Traffic-Aware ETAs
Calculate accurate distances, routing, and travel times dynamically using real-time traffic statistics.
Smart Dispatch Engine
Automatically assign trips to the closest available driver based on distance and route conditions.
Live GPS Tracking
Track driver coordinates in real time using WebSocket channels and push status updates to users.
Dynamic Fare Models
Calculate trip fares using customizable parameters, including distance, duration, vehicle type, and peak hour pricing.
3. API Reference & Technical Endpoints
The API operates over secure HTTPS. Below are the request and response configurations for requesting a ride.
POST https://console.devsecit.com/api/v2/rides/request
Header "Authorization: Bearer YOUR_CAB_API_KEY"
Header "Content-Type: application/json"
{
"customer_id": "cust_98273abc",
"pickup": {
"latitude": 22.5726,
"longitude": 88.3639,
"address": "Park Street, Kolkata"
},
"dropoff": {
"latitude": 22.6547,
"longitude": 88.4467,
"address": "Kolkata Airport"
},
"vehicle_class": "sedan",
"payment_method": "wallet"
}{
"ride_id": "rd_89271ac092",
"status": "searching_driver",
"fare_estimate": {
"base": 100.00,
"distance_fare": 250.00,
"tax": 18.00,
"total": 368.00,
"currency": "INR"
},
"estimated_time_arrival_seconds": 300,
"route_polygon": "sfx}F{tuxM..."
}4. Live GPS Tracking & WebSockets
To provide a seamless tracking experience, we handle location updates through a high-frequency WebSocket proxy:
How it works:
- Driver App Connection: The driver app connects to our WebSocket gateway and broadcasts GPS coordinates every 3 seconds.
- Geofencing Validation: The routing engine checks coordinates against geofencing configurations to detect arrivals or route deviations.
- User App Dispatch: Updates are broadcast to connected user applications, rendering smooth vehicle movement markers on maps.
5. Security, High-Availability & Data Protection
Operating mobility platforms requires maintaining strict security and reliability standards:
- Token & Session Security: Ride requests are signed with client credentials. WebSocket tunnels use secure authentication to protect tracking channels.
- Multi-Region Failovers: Our routing clusters run in multiple availability zones, ensuring service availability during network disruptions.
- Data Masking & Privacy: Protect user privacy. In-app communication channels mask driver and passenger phone numbers.
- Secure Payment Gateways: Payment integrations are PCI-DSS compliant, protecting transactions and card details.
6. Enterprise Use Cases
On-Demand Taxi Platforms
Build custom ride-hailing apps, utilizing our dispatch engine, routing scripts, and tracking APIs.
Corporate Employee Commute
Integrate corporate booking tools to automate employee pick-ups, track routes, and manage corporate billing.
Hotel & Travel Packages
Offer airport transfer bookings directly within travel booking apps or hotel reservation systems.
7. FAQ & Troubleshooting Guide
Q: How does the dispatch engine assign trips?
A: The dispatch engine uses a proximity matching algorithm to assign trips to the nearest available driver based on road distance, traffic conditions, and vehicle type.
Q: Does the API support multiple drop-off points?
A: Yes. You can define an array of coordinate locations in your trip request payload to configure multiple drop-off points.
Q: What happens if a driver cancels a confirmed trip?
A: The system triggers a webhook update to notify the user. The dispatch engine automatically returns the trip request to the active matching pool to search for a new driver.
Q: What is the rate limit for location updates?
A: Location updates via WebSockets are optimized for high frequency. Standard accounts support up to 1,000 concurrent driver connections.
API Documentation
Cab Booking API
Configure Fleet Gateway
Integrate Dispatch & Tracking APIs
Get your developer credentials, configure vehicle categories, and deploy real-time vehicle dispatch workflows today.