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

# Autenticación

> Cómo emitir una clave de API y autenticar solicitudes contra la API pública de Retailgrid.

La API pública de Retailgrid usa tokens bearer. Cada solicitud debe incluir un encabezado `Authorization` con tu clave de API.

```http theme={null}
Authorization: Bearer rg_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```

Las claves de API llevan el prefijo `rg_live_` y están limitadas a una única cuenta de Retailgrid.

## Generar una clave de API

1. Inicia sesión en [app.retailgrid.io](https://app.retailgrid.io).
2. Abre **Settings → Integrations**.
3. Busca la tarjeta **API access** y haz clic en **Generate API Key**.
4. Copia la clave desde la ventana modal.

> [!WARNING]
>
> La clave se muestra **una sola vez**, en el momento de su creación. Retailgrid no almacena el valor en texto plano, así que no se puede recuperar después. Guárdala de inmediato en tu gestor de secretos.

Cada cuenta puede tener **una sola clave activa a la vez**. Generar una clave nueva reemplaza la anterior: las integraciones existentes que usen la clave antigua empezarán a recibir `401 Unauthorized` y deberán actualizarse.

## Verificar una clave

La forma más rápida de comprobar que una clave funciona es llamar a `GET /v1/auth/verify`:

```bash theme={null}
curl https://clientapi.retailgrid.io/v1/auth/verify \
  -H "Authorization: Bearer $RETAILGRID_API_KEY"
```

Una respuesta correcta confirma que la clave es válida y te indica a qué usuario y a qué id de clave pertenece:

```json theme={null}
{
  "ok": true,
  "user_id": "f1c7e0b8-4a2b-4d0e-9a8b-2c3d4e5f6a7b",
  "api_key_id": "9f1c7e0b-4a2b-4d0e-9a8b-2c3d4e5f6a7b"
}
```

Consulta la referencia completa en la página [Verificar clave de API](https://docs.retailgrid.io/es/api-reference/auth/verify.md).

## Modos de fallo

| Estado | Significado |
| - | - |
| `401 Unauthorized` | Falta el encabezado, tiene un formato incorrecto o la clave ya no está activa (rotada, revocada o eliminada). |
| `403 Forbidden` | La clave es válida pero no tiene acceso al recurso solicitado. |

## Recomendaciones de seguridad

* **Nunca subas claves al control de versiones.** Usa variables de entorno, un gestor de secretos o las variables cifradas de tu CI.
* **Rota la clave ante cualquier sospecha.** Generar una clave nueva en la interfaz invalida de inmediato la anterior. No hay un paso de revocación aparte.
* **Usa una clave dedicada por integración** siempre que sea posible. Como hoy cada cuenta tiene una sola clave activa, planifica las rotaciones de clave para que coincidan con los despliegues de los servicios que dependen de ella.
* **Trata las claves como contraseñas.** Una clave filtrada da acceso completo de lectura y escritura a tu catálogo y a tus transacciones en Retailgrid.

## ¿Necesitas ayuda?

Si una clave deja de funcionar de forma inesperada o necesitas restablecer la clave de una cuenta a cuya interfaz ya no tienes acceso, contacta con [soporte](https://retailgrid.io/contact-us).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.