Inicio rápido en cinco minutos

De dónde vienen las credenciales, cómo se autentica una llamada y una solicitud de solo lectura segura.

Versión de la API v1 · Ver como Markdown

PRÓXIMAMENTE — los endpoints siguientes son el contrato publicado, generado desde el registro de operaciones de la plataforma. Aún no se sirven, así que estos comandos no funcionarán hoy.

1. De dónde vienen las credenciales

Tu organización registra una aplicación y recibe un client_id, y un client_secret si es un cliente confidencial. Eso identifica tu APLICACIÓN. Nunca identifica a un cliente y nunca, por sí solo, te permite transaccionar: para eso necesitas un token de acceso que un cliente te haya otorgado.

2. Obtén un token de acceso

# Step 1 — send the customer to Ryde to approve your scopes.
#          code_challenge is the S256 hash of a random verifier you keep.
open "https://auth.ryde.us.com/oauth/authorize?\
response_type=code&\
client_id=$RYDE_CLIENT_ID&\
redirect_uri=https%3A%2F%2Fexample.com%2Fcallback&\
scope=food.read%20rides.read&\
state=$RANDOM_STATE&\
code_challenge=$CODE_CHALLENGE&\
code_challenge_method=S256"

# Step 2 — exchange the code Ryde redirected back with.
curl -sX POST https://auth.ryde.us.com/oauth/token \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d grant_type=authorization_code \
  -d code=$AUTHORIZATION_CODE \
  -d redirect_uri=https://example.com/callback \
  -d client_id=$RYDE_CLIENT_ID \
  -d code_verifier=$CODE_VERIFIER

3. Haz una lectura segura

Buscar comercios no crea nada, no cobra nada y no requiere membresía: la primera llamada correcta.

curl -s 'https://sandbox-api.ryde.us.com/v1/food/merchants?lat=18.4861&lng=-69.9312' \
  -H "Authorization: Bearer $RYDE_ACCESS_TOKEN"

4. Lee la respuesta

Cada respuesta lleva X-Ryde-Request-ID. Guárdalo en tus registros. Es el único valor que permite a soporte encontrar tu llamada exacta, y es lo primero que te pedirán.

5. Luego maneja el límite

Antes de escribir algo que transaccione, lee la página del derecho Ryde One. Un cliente puede conectar su cuenta, explorar y obtener cotizaciones sin membresía, pero crear un viaje, pedido, reserva o tarea la requiere, y tu integración debe explicarlo con elegancia en vez de fallar.