Servicios
Encuentra proveedores que van donde el cliente, consulta su disponibilidad real y reserva una franja. La disponibilidad se deriva por solicitud del estado en vivo del proveedor y su horario publicado; nunca la guardes en caché en el cliente, porque un proveedor que acaba de aceptar un trabajo ya no está disponible.
Encuentra proveedores que van donde el cliente, consulta su disponibilidad real y reserva una franja. La disponibilidad se deriva por solicitud del estado en vivo del proveedor y su horario publicado; nunca la guardes en caché en el cliente, porque un proveedor que acaba de aceptar un trabajo ya no está disponible.
Ciclo de vida
QUOTED
|
REQUESTED or SCHEDULED (booked into a specific slot)
|
ACCEPTED (or rejected by the provider)
|
ON THE WAY
|
IN PROGRESS (some providers require the customer to
| sign a liability waiver before starting)
COMPLETED (or CANCELLED, before work begins)Operaciones
GET /v1/services/providers
Próximamente Compatible con sandbox
Encuentra proveedores que se desplazan al cliente, con su disponibilidad en vivo. La disponibilidad se deriva por solicitud y el cliente nunca debe guardarla en caché.
| Operación | search_service_providers |
|---|---|
| Alcance | services.read |
| Derecho | Ninguno |
| Idempotencia | No requerida |
| Herramienta MCP | search_service_providers |
Solicitud de ejemplo
curl -s 'https://sandbox-api.ryde.us.com/v1/services/providers' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN"GET /v1/services/providers/{provider_id}/slots
Próximamente Compatible con sandbox
Franjas de cita libres en una fecha, para un trabajo de cierta duración. A un trabajo largo solo se le ofrece un inicio cuyas franjas consecutivas estén todas libres.
| Operación | get_provider_availability |
|---|---|
| Alcance | services.read |
| Derecho | Ninguno |
| Idempotencia | No requerida |
| Herramienta MCP | get_provider_availability |
Solicitud de ejemplo
curl -s 'https://sandbox-api.ryde.us.com/v1/services/providers/$provider_id/slots' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN"POST /v1/services/bookings/quote
Próximamente Compatible con sandbox
Cotiza una reserva de servicio antes de comprometer una franja.
| Operación | quote_service |
|---|---|
| Alcance | services.read |
| Derecho | Ninguno |
| Idempotencia | No requerida |
| Herramienta MCP | quote_service |
Solicitud de ejemplo
curl -sX POST 'https://sandbox-api.ryde.us.com/v1/services/bookings/quote' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-d '{ … }'POST /v1/services/bookings
Próximamente Requiere Ryde One Compatible con sandbox
Reserva un proveedor, opcionalmente en una franja concreta. La competencia por una franja la resuelve la plataforma: una reserva perdedora se rechaza, nunca se duplica.
| Operación | book_service |
|---|---|
| Alcance | services.book |
| Derecho | Requiere Ryde One |
| Idempotencia | Obligatoria |
| Herramienta MCP | book_service |
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/services/bookings' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN" \
-H "Idempotency-Key: $(uuidgen)" \
-H 'Content-Type: application/json' \
-d '{ … }'GET /v1/services/bookings/{booking_id}
Próximamente Compatible con sandbox
Estado en vivo de una reserva, desde la llegada hasta el inicio y la finalización.
| Operación | get_service_booking |
|---|---|
| Alcance | services.read |
| Derecho | Ninguno |
| Idempotencia | No requerida |
| Herramienta MCP | get_service_booking |
Solicitud de ejemplo
curl -s 'https://sandbox-api.ryde.us.com/v1/services/bookings/$booking_id' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN"