Viajes
Cotiza una tarifa, solicita un viaje y síguelo hasta el final. Una cotización devuelve la distancia real por carretera, el tiempo de conducción y el precio final por categoría de vehículo, impuestos incluidos: las mismas cifras que muestran las apps de Ryde, porque vienen de la misma ruta de precios.
Cotiza una tarifa, solicita un viaje y síguelo hasta el final. Una cotización devuelve la distancia real por carretera, el tiempo de conducción y el precio final por categoría de vehículo, impuestos incluidos: las mismas cifras que muestran las apps de Ryde, porque vienen de la misma ruta de precios.
Ciclo de vida
QUOTED
|
REQUESTED -----> no driver found -----> cancelled
|
MATCHING (offers go out to nearby drivers in rounds,
| widening the search radius as they lapse)
DRIVER ASSIGNED
|
DRIVER EN ROUTE
|
DRIVER ARRIVED
|
TRIP STARTED
|
COMPLETED (or CANCELLED, before it starts)Operaciones
GET /v1/rides/products
Próximamente Compatible con sandbox
Las categorías de vehículo que se pueden solicitar, con la tarifa base de cada una.
| Operación | search_ride_options |
|---|---|
| Alcance | rides.read |
| Derecho | Ninguno |
| Idempotencia | No requerida |
| Herramienta MCP | search_ride_options |
Solicitud de ejemplo
curl -s 'https://sandbox-api.ryde.us.com/v1/rides/products' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN"POST /v1/rides/quote
Próximamente Compatible con sandbox
Distancia por carretera, tiempo de conducción y la tarifa final por categoría de vehículo, impuestos incluidos. Devuelve el quote_id que requiere request_ride.
| Operación | quote_ride |
|---|---|
| Alcance | rides.read |
| Derecho | Ninguno |
| Idempotencia | No requerida |
| Herramienta MCP | quote_ride |
Solicitud de ejemplo
curl -sX POST 'https://sandbox-api.ryde.us.com/v1/rides/quote' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-d '{ … }'POST /v1/rides
Próximamente Requiere Ryde One Compatible con sandbox
Solicita el viaje que el cliente confirmó, a partir de un quote_id que se le mostró.
| Operación | request_ride |
|---|---|
| Alcance | rides.request |
| Derecho | Requiere Ryde One |
| Idempotencia | Obligatoria |
| Herramienta MCP | request_ride |
Requiere una cotización reciente mostrada al cliente, más una Idempotency-Key.
Solicitud de ejemplo
curl -sX POST 'https://sandbox-api.ryde.us.com/v1/rides' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN" \
-H "Idempotency-Key: $(uuidgen)" \
-H 'Content-Type: application/json' \
-d '{ … }'GET /v1/rides/{ride_id}
Próximamente Compatible con sandbox
Estado en vivo de un viaje: avance del despacho, el conductor y vehículo asignados, y el tiempo estimado de llegada. Nunca restringido por membresía: un viaje en curso sigue siendo rastreable.
| Operación | get_ride |
|---|---|
| Alcance | rides.read |
| Derecho | Ninguno |
| Idempotencia | No requerida |
| Herramienta MCP | get_ride |
Solicitud de ejemplo
curl -s 'https://sandbox-api.ryde.us.com/v1/rides/$ride_id' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN"GET /v1/rides
Próximamente Compatible con sandbox
El historial de viajes del propio cliente, del más reciente al más antiguo.
| Operación | list_rides |
|---|---|
| Alcance | rides.read |
| Derecho | Ninguno |
| Idempotencia | No requerida |
| Herramienta MCP | list_rides |
Solicitud de ejemplo
curl -s 'https://sandbox-api.ryde.us.com/v1/rides' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN"POST /v1/rides/{ride_id}/cancel
Próximamente Compatible con sandbox
Cancela un viaje que no ha comenzado. Nunca restringido por membresía, por la misma razón que cancelar un pedido.
| Operación | cancel_ride |
|---|---|
| Alcance | rides.read |
| Derecho | Ninguno |
| Idempotencia | Compatible |
| Herramienta MCP | cancel_ride |
Solicitud de ejemplo
curl -sX POST 'https://sandbox-api.ryde.us.com/v1/rides/$ride_id/cancel' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-d '{ … }'