# 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.

> **Note:** 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

```bash
# 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.

```bash
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.