> ## Documentation Index
> Fetch the complete documentation index at: https://docs.riqra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Inicio rápido

> Haz tu primera llamada autenticada a la API pública.

En esta guía obtienes una API key, verificas tu identidad y consultas tus pedidos.

<Steps>
  <Step title="Obtén una API key">
    Genera una key desde el panel de administración. Revisa [Autenticación](/new-api/authentication)
    para el detalle. Una key de producción empieza con `rq_live_`; una de prueba con `rq_test_`.
  </Step>

  <Step title="Verifica tu identidad">
    Llama a `GET /whoami` para confirmar que la key funciona y ver sus permisos.

    ```bash theme={null}
    curl https://api-v2.riqra.com/public/v1/whoami \
      -H "Authorization: Bearer rq_live_tu_api_key"
    ```

    Respuesta:

    ```json theme={null}
    {
      "organizationId": "0b2e9f5a-1c3d-4e6f-8a9b-0c1d2e3f4a5b",
      "environment": "LIVE",
      "apiKeyPrefix": "rq_live_abcd",
      "scopes": ["orders:read", "fulfillment:write"]
    }
    ```
  </Step>

  <Step title="Lista tus pedidos">
    Con el scope `orders:read`, consulta los pedidos más recientes.

    ```bash theme={null}
    curl "https://api-v2.riqra.com/public/v1/orders?limit=5" \
      -H "Authorization: Bearer rq_live_tu_api_key"
    ```

    La respuesta trae `data`, más `hasMore` y `nextCursor` para paginar. Revisa
    [Paginación](/new-api/pagination).
  </Step>
</Steps>

## Si algo falla

* `401`: falta el header `Authorization` o la key es inválida o expiró.
* `403`: la key no tiene el scope requerido. Revisa [Permisos](/new-api/scopes).

Cada error trae un cuerpo con `code`, `message` y `requestId`. Revisa [Errores](/new-api/errors).