Tareas
Da a tu software y a tus agentes de IA acceso a la ejecución en el mundo real: solicitudes estructuradas de trabajo físico, realizadas por la red de proveedores de Ryde y devueltas con evidencia. Una Tarea es un recurso propio con su propio ciclo de vida; cómo Ryde la asigna internamente no forma parte del contrato y puede cambiar.
Da a tu software y a tus agentes de IA acceso a la ejecución en el mundo real: solicitudes estructuradas de trabajo físico, realizadas por la red de proveedores de Ryde y devueltas con evidencia. Una Tarea es un recurso propio con su propio ciclo de vida; cómo Ryde la asigna internamente no forma parte del contrato y puede cambiar.
Ciclo de vida
QUOTED
|
CREATED
|
PROVIDER ASSIGNED (matched on skill, territory and availability)
|
STARTED
|
EVIDENCE COLLECTED (photos with content hashes, capture GPS,
| device timestamps, checklist answers)
COMPLETED (or CANCELLED, before work begins)Operaciones
GET /v1/tasks/types
Próximamente Compatible con sandbox
Los tipos de tarea que este mercado puede ejecutar realmente, con la evidencia que recoge cada uno. Solo se listan los tipos que Ryde puede cubrir con personal.
| Operación | list_task_types |
|---|---|
| Alcance | tasks.read |
| Derecho | Ninguno |
| Idempotencia | No requerida |
| Herramienta MCP | list_task_types |
Solicitud de ejemplo
curl -s 'https://sandbox-api.ryde.us.com/v1/tasks/types' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN"POST /v1/tasks/quote
Próximamente Compatible con sandbox
Cotiza una tarea y confirma que podría encontrarse un proveedor calificado antes de comprometerse.
| Operación | quote_task |
|---|---|
| Alcance | tasks.read |
| Derecho | Ninguno |
| Idempotencia | No requerida |
| Herramienta MCP | quote_task |
Solicitud de ejemplo
curl -sX POST 'https://sandbox-api.ryde.us.com/v1/tasks/quote' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-d '{ … }'POST /v1/tasks
Próximamente Requiere Ryde One Compatible con sandbox
Despacha trabajo del mundo real con requisitos estructurados y reglas de evidencia.
| Operación | create_task |
|---|---|
| Alcance | tasks.create |
| Derecho | Requiere Ryde One |
| Idempotencia | Obligatoria |
| Herramienta MCP | create_task |
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/tasks' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN" \
-H "Idempotency-Key: $(uuidgen)" \
-H 'Content-Type: application/json' \
-d '{ … }'GET /v1/tasks/{task_id}
Próximamente Compatible con sandbox
Estado de la tarea, el proveedor asignado y la evidencia recogida hasta el momento.
| Operación | get_task |
|---|---|
| Alcance | tasks.read |
| Derecho | Ninguno |
| Idempotencia | No requerida |
| Herramienta MCP | get_task |
Solicitud de ejemplo
curl -s 'https://sandbox-api.ryde.us.com/v1/tasks/$task_id' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN"GET /v1/tasks/{task_id}/evidence
Próximamente Compatible con sandbox
La evidencia recogida para una tarea: fotos con sus hashes de contenido, GPS de captura, marcas de tiempo del dispositivo y las respuestas de cualquier lista de verificación.
| Operación | get_task_evidence |
|---|---|
| Alcance | tasks.read |
| Derecho | Ninguno |
| Idempotencia | No requerida |
| Herramienta MCP | get_task_evidence |
Solicitud de ejemplo
curl -s 'https://sandbox-api.ryde.us.com/v1/tasks/$task_id/evidence' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN"POST /v1/tasks/{task_id}/cancel
Próximamente Compatible con sandbox
Cancela una tarea que no ha comenzado.
| Operación | cancel_task |
|---|---|
| Alcance | tasks.read |
| Derecho | Ninguno |
| Idempotencia | Compatible |
| Herramienta MCP | cancel_task |
Solicitud de ejemplo
curl -sX POST 'https://sandbox-api.ryde.us.com/v1/tasks/$task_id/cancel' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-d '{ … }'