Claves API
Cada cuenta puede crear un máximo de 3 claves API desde la Página de Integración. Si ya te has registrado, habrás creado una durante la incorporación. Trophy realiza un seguimiento y muestra cuándo se creó cada clave API en tu cuenta y cuándo se usó por última vez para que puedas rastrear fácilmente el uso.
Anatomía de una clave API
Cada clave API está compuesta por 2 partes separadas por un punto:- El prefijo son los primeros 8 caracteres. Es legible y siempre permanecerá igual para que sea fácilmente reconocible.
- El cuerpo es la parte secreta y solo se te muestra una vez cuando creas la clave.
Al utilizar la API, ambas partes de tu clave API deben enviarse en el encabezado
X-API-KEY.Autenticación de Solicitudes
Al realizar solicitudes a la API, asegúrate de incluir ambas partes de tu clave API en el encabezadoX-API-KEY como en este ejemplo:
401.
Gestión de claves API
Existen varias operaciones diferentes que puedes realizar con las claves API desde tu panel de Trophy para gestionar tu integración.
Rotación de claves
Las claves de API se pueden rotar si deseas cambiarlas por cualquier motivo. En el momento de la rotación, la clave de API original dejará de funcionar inmediatamente y cualquier solicitud que aún la utilice comenzará a recibir respuestas401.
Ten en cuenta que al rotar las claves, tanto el prefijo como el cuerpo cambiarán.
Revocación de claves
Las claves de API también se pueden revocar por completo, momento en el cual pasan a estar Inactivas. En el momento de la revocación, la clave de API dejará de funcionar inmediatamente y cualquier solicitud que aún la utilice comenzará a recibir respuestas401.
Una vez revocada, puedes reactivar la clave de API en cualquier momento.
Ni el prefijo ni el cuerpo de la clave cambian cuando se revoca o se reactiva.