Skip to main content
La API pública de Retailgrid usa tokens bearer. Cada solicitud debe incluir un encabezado Authorization con tu clave de API.
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.
  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.
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:
Una respuesta correcta confirma que la clave es válida y te indica a qué usuario y a qué id de clave pertenece:
Consulta la referencia completa en la página Verificar clave de API.

​
Modos de fallo

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