Transporte

Entrega paquetes a Ryde para que los reparta. Esta es la superficie que un operador logístico o un marketplace integra una vez y luego olvida: consulta si un código postal tiene cobertura, envía un manifiesto de hasta 500 paquetes en una sola solicitud y sigue cada uno por su número de rastreo de Ryde hasta que se entregue, se rechace o se devuelva. Cada paquete responde con el mismo vocabulario de siete estados que espera un agregador de rastreo, así que el flujo que construyas aquí es el que tus clientes ya saben leer. El acceso requiere una organización transportista aprobada con un Acuerdo de Transporte de Ryde firmado; los precios vienen de la tarifa de ese acuerdo, no de una cotización por solicitud.

Versión de la API v1 · Ver como Markdown

Entrega paquetes a Ryde para que los reparta. Esta es la superficie que un operador logístico o un marketplace integra una vez y luego olvida: consulta si un código postal tiene cobertura, envía un manifiesto de hasta 500 paquetes en una sola solicitud y sigue cada uno por su número de rastreo de Ryde hasta que se entregue, se rechace o se devuelva. Cada paquete responde con el mismo vocabulario de siete estados que espera un agregador de rastreo, así que el flujo que construyas aquí es el que tus clientes ya saben leer. El acceso requiere una organización transportista aprobada con un Acuerdo de Transporte de Ryde firmado; los precios vienen de la tarifa de ese acuerdo, no de una cotización por solicitud.

Ciclo de vida

  CREATED               (we have the parcel's details, not the parcel)
     |
  AT HUB / SORTED       (it is at the depot it will be collected from)
     |
  COLLECTED             (a courier has it in hand, scanned at the depot)
     |
  OUT FOR DELIVERY      (the run has started; the recipient is told)
     |
  DELIVERED  <----+     (photo and recipient name are the proof)
     |            |
  ATTEMPTED ------+     (nobody home, refused, cannot reach the door;
     |                   it goes back on a later run)
  RETURNED TO HUB
     |
  RETURNED TO SHIPPER   (attempts exhausted, or you asked for it back)

  You may CANCEL at any point before a parcel is delivered or returned
  — including while it is already on a van.

Operaciones

curl -s 'https://sandbox-api.ryde.us.com/v1/coverage' \
  -H "Authorization: Bearer $RYDE_ACCESS_TOKEN"

curl -s 'https://sandbox-api.ryde.us.com/v1/rates' \
  -H "Authorization: Bearer $RYDE_ACCESS_TOKEN"

curl -sX POST 'https://sandbox-api.ryde.us.com/v1/shipments' \
  -H "Authorization: Bearer $RYDE_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{ … }'

curl -sX POST 'https://sandbox-api.ryde.us.com/v1/shipments/batch' \
  -H "Authorization: Bearer $RYDE_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{ … }'

curl -s 'https://sandbox-api.ryde.us.com/v1/shipments/$tracking_number' \
  -H "Authorization: Bearer $RYDE_ACCESS_TOKEN"

curl -s 'https://sandbox-api.ryde.us.com/v1/shipments' \
  -H "Authorization: Bearer $RYDE_ACCESS_TOKEN"

curl -sX POST 'https://sandbox-api.ryde.us.com/v1/shipments/$tracking_number/cancel' \
  -H "Authorization: Bearer $RYDE_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{ … }'

curl -s 'https://sandbox-api.ryde.us.com/v1/shipments/$tracking_number/events' \
  -H "Authorization: Bearer $RYDE_ACCESS_TOKEN"

curl -s 'https://sandbox-api.ryde.us.com/v1/hubs' \
  -H "Authorization: Bearer $RYDE_ACCESS_TOKEN"