Comida
Busca restaurantes, supermercados y tiendas, lee un menú, cotiza una canasta y haz un pedido. No hay carrito del lado servidor: envías los artículos que quieres con la cotización, y la cotización que recibiste es el pedido que haces.
Busca restaurantes, supermercados y tiendas, lee un menú, cotiza una canasta y haz un pedido. No hay carrito del lado servidor: envías los artículos que quieres con la cotización, y la cotización que recibiste es el pedido que haces.
Ciclo de vida
QUOTED
|
PLACED
|
MERCHANT ACCEPTED ----> rejected
|
PREPARING
|
READY FOR PICKUP
|
COURIER ASSIGNED (skipped when the customer collects it)
|
PICKED UP
|
DELIVERING
|
DELIVERED (or CANCELLED, before pickup)
Operaciones
GET /v1/food/merchants
Próximamente Compatible con sandbox
Encuentra restaurantes, supermercados y tiendas abiertos cerca de un punto.
| Operación | search_restaurants |
|---|---|
| Alcance | food.read |
| Derecho | Ninguno |
| Idempotencia | No requerida |
| Herramienta MCP | search_restaurants |
Solicitud de ejemplo
curl -s 'https://sandbox-api.ryde.us.com/v1/food/merchants' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN"
POST /v1/food/orders/quote
Próximamente Compatible con sandbox
Cotiza una canasta exactamente como lo haría el checkout: artículos, cargos, impuestos, cualquier descuento de miembro y el total. Devuelve el quote_id que requiere place_food_order.
| Operación | quote_food_order |
|---|---|
| Alcance | food.read |
| Derecho | Ninguno |
| Idempotencia | No requerida |
| Herramienta MCP | quote_food_order |
Solicitud de ejemplo
curl -sX POST 'https://sandbox-api.ryde.us.com/v1/food/orders/quote' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-d '{ … }'
POST /v1/food/orders
Próximamente Requiere Ryde One Compatible con sandbox
Realiza el pedido que el cliente confirmó, a partir de un quote_id que se le mostró.
| Operación | place_food_order |
|---|---|
| Alcance | food.order |
| Derecho | Requiere Ryde One |
| Idempotencia | Obligatoria |
| Herramienta MCP | place_food_order |
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/food/orders' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN" \
-H "Idempotency-Key: $(uuidgen)" \
-H 'Content-Type: application/json' \
-d '{ … }'
GET /v1/food/orders/{order_id}
Próximamente Compatible con sandbox
Estado en vivo de un pedido, incluido el avance del mensajero. Deliberadamente SIN restricción de membresía: un pedido que existe sigue siendo rastreable.
| Operación | get_food_order |
|---|---|
| Alcance | food.read |
| Derecho | Ninguno |
| Idempotencia | No requerida |
| Herramienta MCP | get_food_order |
Solicitud de ejemplo
curl -s 'https://sandbox-api.ryde.us.com/v1/food/orders/$order_id' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN"
GET /v1/food/orders
Próximamente Compatible con sandbox
El historial de pedidos del propio cliente, del más reciente al más antiguo.
| Operación | list_food_orders |
|---|---|
| Alcance | food.read |
| Derecho | Ninguno |
| Idempotencia | No requerida |
| Herramienta MCP | list_food_orders |
Solicitud de ejemplo
curl -s 'https://sandbox-api.ryde.us.com/v1/food/orders' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN"
POST /v1/food/orders/{order_id}/cancel
Próximamente Compatible con sandbox
Cancela un pedido, cuando su estado actual aún lo permite. Nunca restringido por membresía: SALIR de una transacción no debe requerir un derecho.
| Operación | cancel_food_order |
|---|---|
| Alcance | food.read |
| Derecho | Ninguno |
| Idempotencia | Compatible |
| Herramienta MCP | cancel_food_order |
Solicitud de ejemplo
curl -sX POST 'https://sandbox-api.ryde.us.com/v1/food/orders/$order_id/cancel' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-d '{ … }'