Convenciones
Lo que es cierto en toda llamada a la API de Ryde.
| Tema | Convención |
|---|---|
| Transporte | Solo HTTPS. El HTTP simple se rechaza, nunca se redirige: una redirección ya habría filtrado el token. |
| Formato | Cuerpos JSON de solicitud y respuesta, UTF-8. |
| Versión | En la ruta: /v1/… |
| Autenticación | Authorization: Bearer <token de acceso> |
| Identificadores | Cadenas opacas. No las analices ni asumas longitud o alfabeto: no se garantiza que tengan la misma forma entre productos. |
| Marcas de tiempo | RFC 3339 con desplazamiento explícito. Las horas de cita también se devuelven en la hora local del mercado, porque un cliente piensa en hora local. |
| Dinero | Un importe con código de moneda explícito, en la moneda del mercado. Nunca asumas USD. |
| Precisión de precios | Un precio unitario (el precio de un producto, el unit_price de una línea, un precio de lista) puede llevar hasta 4 decimales: 512.7119 es un precio real que con ITBIS 18% cobra 605.00. Los totales de línea, el impuesto (ITBIS) y los totales del pedido siempre se redondean a 2 decimales. Nunca redondees un precio unitario a 2 antes de multiplicar; lee los totales que devuelve Ryde. |
| Ubicación | Latitud/longitud decimales, más una dirección legible cuando se conoce. |
| Id de solicitud | X-Ryde-Request-ID en cada respuesta. Regístralo; soporte lo necesita. |
El mercado inicial de Ryde es República Dominicana y los precios se cotizan en pesos dominicanos. Cualquier cifra que muestres a un cliente debe venir de una respuesta de Ryde con su moneda, nunca de una operación aritmética hecha en tu cliente.