Tu primera integración con Ryde

De una cuenta de desarrollador a una llamada sandbox funcional, en diez pasos.

Versión de la API v1 · Ver como Markdown

PRÓXIMAMENTE — el registro de desarrolladores aún no está abierto. El flujo siguiente es el que se está construyendo, publicado ahora para que veas lo que implicará integrar y plantees lo que no te funcionaría.

1. Crea una cuenta de desarrolladorInicia sesión con la misma identidad Ryde basada en teléfono que usan los clientes. Una cuenta de desarrollador es una cuenta Ryde con acceso de desarrollador, no un inicio de sesión aparte.
2. Crea o únete a una organizaciónLas aplicaciones pertenecen a una organización, nunca a una persona. Es deliberado: la gente cambia de trabajo y las credenciales no deben irse con ella.
3. Acepta el Acuerdo de DesarrolladorSe firma una vez por organización, con firma electrónica y versionado. Es distinto de la membresía Ryde One de un cliente y del Acuerdo Comercial de un comercio: tres relaciones diferentes.
4. Registra una aplicaciónNombre, logo, sitio web, política de privacidad, URIs de redirección y los alcances que solicitas. Pide los mínimos alcances con los que tu producto funcione.
5. Recibe credenciales de sandboxSe emiten de inmediato. El sandbox nunca despacha un conductor real, nunca cobra una tarjeta real y nunca llega a un comercio real.
6. Implementa OAuthCódigo de autorización con PKCE. El cliente inicia sesión en Ryde y aprueba tus alcances en una pantalla alojada por Ryde; nunca ves sus credenciales.
7. Haz tu primera lecturaBusca comercios o cotiza una tarifa. Las lecturas y cotizaciones no requieren membresía, así que funcionan para todo cliente conectado desde el principio.
8. Prueba el límite de Ryde OneIntenta transaccionar como cliente sin membresía y maneja bien el 403 RYDE_ONE_REQUIRED. Es el error de integración más común, y el sandbox permite reproducirlo cuando quieras.
9. Prueba fallos y cancelacionesSin conductor disponible, un comercio que rechaza un pedido, un cliente que cancela. Un agente que solo maneja el camino feliz no está terminado.
10. Solicita acceso a producciónEl sandbox es automático; producción se revisa, porque estas APIs mueven vehículos reales, comida real y el dinero de personas reales.