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

# Autenticación

> Autentícate con la API de aplicación mediante claves de API de aplicación con alcance de usuario, enviadas en el encabezado `X-API-KEY`.

## Tipos de claves de API

La API de aplicación acepta dos tipos de claves de API:

| Tipo de clave | Alcance | Dónde se usa | ¿Es seguro en el cliente? |
| - | - | - | - |
| [Claves de API de aplicación](#application-api-keys) | Un solo usuario | Solo la API de aplicación | Sí |
| [Claves de API de administrador](/es/admin-api/authentication.md) | Toda la cuenta | API de aplicación y API de administrador | No |

Usa claves de API de aplicación cuando quieras que los usuarios finales o las aplicaciones cliente llamen a la API de aplicación con permisos limitados a un solo usuario. Usa [claves de API de administrador](/es/admin-api/authentication.md) para integraciones de confianza en el servidor que necesiten un acceso amplio.

## Claves de API de aplicación

Las claves de API de aplicación tienen alcance de un usuario específico. Cada clave solo puede realizar operaciones de la API de aplicación en nombre del usuario para el que se creó, lo que permite exponerlas de forma segura en entornos del lado del cliente.

Las claves de API de aplicación no se pueden usar con la API de administrador.

### Crear claves de API de aplicación

Crea claves de API de aplicación con la [API de administrador](/es/admin-api/endpoints/application-api-keys/create-application-api-keys.md). Esa solicitud se autentica con una [clave de API de administrador](/es/admin-api/authentication.md).

Puedes crear claves para un máximo de 100 usuarios por solicitud. El valor completo de la clave se devuelve una sola vez al crearla y no se puede recuperar de nuevo: guárdalo de forma segura o entrégalo al cliente de inmediato.

```bash cURL theme={null}
curl -X POST https://admin.trophy.so/v1/application-api-keys \
     -H "X-API-KEY: <api-key>" \
     -H "Content-Type: application/json" \
     -d '[
       { "userId": "user_123" },
       { "userId": "user_456" }
     ]'
```

```typescript Node theme={null}
await trophy.admin.applicationApiKeys.create([
  { userId: "user_123" },
  { userId: "user_456" },
]);
```

```python Python theme={null}
client.admin.application_api_keys.create(
    request=[
        CreateApplicationKeyRequestItem(
            user_id="user_123",
        ),
        CreateApplicationKeyRequestItem(
            user_id="user_456",
        ),
    ],
)
```

```php PHP theme={null}
$trophy->admin->applicationApiKeys->create([
    ['userId' => 'user_123'],
    ['userId' => 'user_456'],
]);
```

```java Java theme={null}
CreateApplicationKeysResponse response = client.admin().applicationApiKeys().create(
  List.of(
    CreateApplicationKeyRequestItem.builder().userId("user_123").build(),
    CreateApplicationKeyRequestItem.builder().userId("user_456").build()
  )
);
```

```go Go theme={null}
response, err := client.Admin.ApplicationApiKeys.Create(
    context.TODO(),
    []*api.CreateApplicationKeyRequestItem{
        {UserId: "user_123"},
        {UserId: "user_456"},
    },
)
```

```csharp C# theme={null}
await trophy.Admin.ApplicationApiKeys.CreateAsync(new[]
{
    new CreateApplicationKeyRequestItem { UserId = "user_123" },
    new CreateApplicationKeyRequestItem { UserId = "user_456" },
});
```

```ruby Ruby theme={null}
result = client.admin.application_api_keys.create([
  { user_id: 'user_123' },
  { user_id: 'user_456' }
])
```

Una respuesta correcta incluye el ID de la clave (que se usa más adelante para eliminarla), el ID del usuario, la clave completa y un prefijo legible:

```json theme={null}
{
  "created": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "userId": "user_123",
      "key": "app_XXXXX.YOUR_API_KEY",
      "prefix": "app_XXXXX"
    }
  ],
  "issues": []
}
```

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

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

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

* El *prefijo* identifica la clave (por ejemplo, `app_XXXXX`) y se puede registrar o mostrar sin riesgo.
* El *cuerpo* es la parte secreta y solo se muestra una vez, cuando creas la clave.

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

### Autenticación de solicitudes

Incluye la clave de API de aplicación completa en el encabezado `X-API-KEY` de las solicitudes a la Application API, o pásala al inicializar un cliente del SDK. La clave solo autoriza operaciones para el usuario al que está asociada; las solicitudes para otros usuarios devuelven un error.

```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 si tu clave de API no es válida, recibirás un código de respuesta `401`.

### Eliminación de claves de API de aplicación

Elimina las claves de API de aplicación por ID con la [Admin API](/es/admin-api/endpoints/application-api-keys/delete-application-api-keys.md). Usa el UUID que se devolvió cuando se creó la clave.

```bash cURL theme={null}
curl -X DELETE "https://admin.trophy.so/v1/application-api-keys?ids=550e8400-e29b-41d4-a716-446655440000" \
     -H "X-API-KEY: <api-key>"
```

```typescript Node theme={null}
await trophy.admin.applicationApiKeys.delete({
  ids: ["550e8400-e29b-41d4-a716-446655440000"],
});
```

```python Python theme={null}
client.admin.application_api_keys.delete(
    ids=["550e8400-e29b-41d4-a716-446655440000"],
)
```

```php PHP theme={null}
$trophy->admin->applicationApiKeys->delete([
    'ids' => ['550e8400-e29b-41d4-a716-446655440000'],
]);
```

```java Java theme={null}
DeleteApplicationKeysResponse response = client.admin().applicationApiKeys().delete(
  ApplicationApiKeysDeleteRequest.builder()
    .ids(List.of("550e8400-e29b-41d4-a716-446655440000"))
    .build()
);
```

```go Go theme={null}
response, err := client.Admin.ApplicationApiKeys.Delete(
    context.TODO(),
    &admin.ApplicationApiKeysDeleteRequest{
        Ids: []*string{
            api.String("550e8400-e29b-41d4-a716-446655440000"),
        },
    },
)
```

```csharp C# theme={null}
await trophy.Admin.ApplicationApiKeys.DeleteAsync(new ApplicationApiKeysDeleteRequest
{
    Ids = new[] { "550e8400-e29b-41d4-a716-446655440000" },
});
```

```ruby Ruby theme={null}
result = client.admin.application_api_keys.delete(
  ids: ['550e8400-e29b-41d4-a716-446655440000']
)
```

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

## Obtener soporte

¿Quieres ponerte en contacto con el equipo de Trophy? Comunícate con nosotros 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.