Skip to main content

​
Autenticación con API key

Cada petición a la Omni API se autentica con la cabecera x-api-key. Las keys se emiten por proyecto, y una key solo puede trabajar con los recursos de su propio proyecto.

​
Obtener una API key

1

Seleccione un proyecto

Inicie sesión en el panel de Omni y abra un proyecto de la lista. Al crear el proyecto se emite una API key junto con él.
2

Project Management → pestaña API Key

Abra la pestaña API Key dentro de Project Management, en la barra lateral. La key aparece oculta; muéstrela con el icono de ojo o use el botón de copia.
3

Guárdela de forma segura

Consérvela en una variable de entorno o en un gestor de secretos. Nunca la exponga en código de cliente, en un repositorio público ni en registros.
Si sospecha que la key quedó expuesta, regenérela en esa misma pestaña. La key antigua queda invalidada de inmediato, y las llamadas reciben 401 hasta que termine de desplegar la nueva. El procedimiento está en API key.

​
Base URL y cabeceras

Detrás de un firewall o un proxy, permita HTTPS saliente (443) hacia client-omni-api.argosidentity.com.

​
Errores de autenticación

El formato del cuerpo de error está en la descripción general de la API.