Sandbox

Construye y prueba sin despachar un conductor real ni cobrar una tarjeta real.

Versión de la API v1 · Ver como Markdown

PRÓXIMAMENTE — el sandbox aún no está abierto.

El sandbox es un entorno aparte con credenciales aparte y una URL base aparte. Nada de lo que hagas allí llega a un conductor, mensajero, proveedor, comercio o método de pago real.

Estos nombres de host son los destinos publicados para la Red de Agentes. Aún no resuelven —la API de la plataforma responde por ahora solo en su origen interno— y esta página indicará el estado en vivo cuando lo hagan.

Qué se simula

• Las transacciones —viajes, pedidos, entregas, reservas y tareas— se guardan en un almacén aparte que el mercado nunca lee. No se despacha ningún conductor, no se notifica a ningún comercio, no se mueve dinero y no se envía ninguna notificación push. El aislamiento es estructural, no una bandera, así que nada tiene que acordarse de filtrar tus datos de prueba.
• El descubrimiento, los menús, la disponibilidad y las COTIZACIONES son reales. Un catálogo falso te enseñaría a integrar contra comercios y precios que no existen, así que las lecturas del sandbox responden desde el mercado en vivo.
• Fallos que debes manejar: sin conductor disponible, comercio que rechaza, franja perdida ante otro, pago rechazado.
• El límite de Ryde One, en ambos lados: un cliente de prueba con membresía y otro sin ella, para ejercitar la ruta 403 deliberadamente.

Controlar tú mismo un ciclo de vida

Ningún conductor va a aceptar tu viaje de prueba y ningún comercio va a marcar tu ticket como listo, así que esperar haría imposible probar los casos interesantes. Avanza un recurso del sandbox cuando quieras:

curl -sX POST 'https://sandbox-api.ryde.us.com/v1/sandbox/simulate' \
  -H "Authorization: Bearer $RYDE_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{ "resource_id": "<id>", "status": "driver_assigned" }'

Las transiciones ofrecidas son las máquinas de estado reales de la plataforma, así que un manejador escrito contra el sandbox funciona en producción. Un cambio que la máquina real no permite se rechaza, y el rechazo enumera lo disponible desde el estado actual.

El control existe solo para credenciales de sandbox. Un token de producción que lo invoque es rechazado: nada puede reescribir desde fuera el estado de un viaje o pedido real.

El sandbox es para corrección, no para carga. Sus límites son menores que los de producción, y aprobar en sandbox no demuestra por sí solo que tu integración aguantará tráfico real.