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

# Autenticación

> Integra de forma segura con la API de administración mediante claves de API de administración a nivel de cuenta, transmitidas en el encabezado `X-API-KEY`.

> [!TIP]
>
> Para el acceso desde el cliente o de usuarios finales a la API de aplicación,
> crea en su lugar [claves de API de aplicación](/es/api-reference/authentication.md)
> limitadas a un solo usuario.

## Claves de API de administración

Las claves de API de administración son credenciales a nivel de cuenta con permisos amplios. Úsalas para autenticar las solicitudes a la API de administración y, opcionalmente, a la [API de aplicación](/es/api-reference/authentication.md) desde entornos de servidor de confianza.

Cada cuenta puede crear un máximo de 3 claves de API de administración desde la [página de integración](https://app.trophy.so/integration) del panel de Trophy.

Trophy registra y muestra cuándo se creó cada clave de API de administración de tu cuenta y cuándo se usó por última vez, para que puedas hacer un seguimiento sencillo del uso.

![](https://mintcdn.com/trophy-cep/KNKynR4KUMaS-uCh/assets/api/authentication/api_keys.png?fit=max\&auto=format\&n=KNKynR4KUMaS-uCh\&q=85\&s=3283ab9f82404dbc5b52bb255c7036b8)

> [!WARNING]
>
> Las claves de API de administración pueden acceder a cualquier usuario y a cualquier operación de administración de tu cuenta.
> No las expongas nunca en código del lado del cliente, aplicaciones móviles ni repositorios públicos.

### Anatomía de una clave de API de administración

Cada clave de API de administración consta de 2 partes separadas por un punto:

```bash theme={null}
{prefix}.{body}
```

* El *prefijo* son los primeros 8 caracteres. Es legible y siempre permanece igual, por lo que es fácil de reconocer.
* El *cuerpo* es la parte secreta y solo se muestra una vez, cuando creas la clave.

> [!NOTE]
>
> Al usar la API, ambas partes de tu clave de API de administración deben enviarse en el
> encabezado `X-API-KEY`.

### Autenticación de solicitudes

Al realizar solicitudes a la API de administración, incluye ambas partes de tu clave de API de administrador en el encabezado `X-API-KEY`, o pásala al inicializar un cliente del SDK:

```bash cURL theme={null}
curl https://admin.trophy.so/v1/metrics \
     -H "X-API-KEY: YOUR_API_KEY"
```

```typescript Node theme={null}
import { TrophyApiClient } from "@trophyso/node";

const trophy = new TrophyApiClient({
  apiKey: "YOUR_API_KEY",
});
```

```python Python theme={null}
from trophy import TrophyApi

client = TrophyApi(
    api_key="YOUR_API_KEY",
)
```

```php PHP theme={null}
use Trophy\TrophyClient;

$trophy = new TrophyClient("YOUR_API_KEY");
```

```java Java theme={null}
TrophyApiClient client = TrophyApiClient.builder()
    .apiKey("YOUR_API_KEY")
    .build();
```

```go Go theme={null}
import (
  trophyclient "github.com/trophyso/trophy-go/client"
  "github.com/trophyso/trophy-go/option"
)

client := trophyclient.NewClient(
  option.WithApiKey("YOUR_API_KEY"),
)
```

```csharp C# theme={null}
var trophy = new TrophyApiClient(
    apiKey: "YOUR_API_KEY"
);
```

```ruby Ruby theme={null}
client = Trophy::Client.new(
  api_key: "YOUR_API_KEY"
)
```

La misma clave autentica las solicitudes a la API de aplicación cuando usas una clave de API de administrador desde un entorno de servidor:

```bash cURL theme={null}
curl https://api.trophy.so/v1/users/user_123/metrics/<key> \
     -H "X-API-KEY: YOUR_API_KEY"
```

```typescript Node theme={null}
import { TrophyApiClient } from "@trophyso/node";

const trophy = new TrophyApiClient({
  apiKey: "YOUR_API_KEY",
});
```

```python Python theme={null}
from trophy import TrophyApi

client = TrophyApi(
    api_key="YOUR_API_KEY",
)
```

```php PHP theme={null}
use Trophy\TrophyClient;

$trophy = new TrophyClient("YOUR_API_KEY");
```

```java Java theme={null}
TrophyApiClient client = TrophyApiClient.builder()
    .apiKey("YOUR_API_KEY")
    .build();
```

```go Go theme={null}
import (
  trophyclient "github.com/trophyso/trophy-go/client"
  "github.com/trophyso/trophy-go/option"
)

client := trophyclient.NewClient(
  option.WithApiKey("YOUR_API_KEY"),
)
```

```csharp C# theme={null}
var trophy = new TrophyApiClient(
    apiKey: "YOUR_API_KEY"
);
```

```ruby Ruby theme={null}
client = Trophy::Client.new(
  api_key: "YOUR_API_KEY"
)
```

Si no pasas una clave de API, o tu clave de API no es válida, recibirás un código de respuesta `401`.

## Gestión de las claves de API de administrador

Hay varias operaciones que puedes realizar con las claves de API de administrador desde tu panel de Trophy para gestionar tu integración.

![](https://mintcdn.com/trophy-cep/KNKynR4KUMaS-uCh/assets/api/authentication/api_key_options.png?fit=max\&auto=format\&n=KNKynR4KUMaS-uCh\&q=85\&s=eefb892b4a347aa715e6d49315698ba0)

### Rotación de claves

Las claves de API de administrador se pueden rotar si quieres cambiarlas por cualquier motivo. En el momento de la rotación, la clave de API original dejará de funcionar y las solicitudes que sigan usándola empezarán a recibir respuestas `401` de inmediato.

> [!NOTE]
>
> Ten en cuenta que, al rotar las claves, cambian tanto el prefijo como el cuerpo.

### Revocación de claves

Las claves de API de administrador también se pueden revocar por completo, y en ese caso pasan a estar *inactivas*. En el momento de la revocación, la clave de API dejará de funcionar y las solicitudes que sigan usándola empezarán a recibir respuestas `401` de inmediato.

Una vez revocada, puedes volver a activar la clave de API en cualquier momento.

> [!NOTE]
>
> Ni el prefijo ni el cuerpo de la clave cambian al revocarla o volver a activarla.

### Eliminación de claves de API

Si estás 100 % seguro de que ya no necesitas una clave de API de administrador, puedes eliminarla.

> [!CAUTION]
>
> Una vez eliminadas las claves de API, no se pueden recuperar.

## Obtener soporte

¿Quieres ponerte en contacto con el equipo de Trophy? Escríbenos por [correo electrónico](mailto:support@trophy.so). ¡Estamos aquí para ayudarte!


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