# Autenticación

Crea una clave en el panel. Abre **Integrations & APIs**, luego **API & SDK** y después **API keys**. La clave completa se muestra una sola vez. Empieza por `apk_`. Guárdala como un secreto. Después el panel solo conserva un prefijo y los últimos cuatro caracteres.

Envíala en cada solicitud, excepto en las rutas de administración de claves.

```
Authorization: Bearer $ATOMICPLAYER_API_KEY
```

```bash
curl "https://api.atomicplayer.ai/v1/videos?workspaceId=$WORKSPACE_ID" \
  -H "Authorization: Bearer $ATOMICPLAYER_API_KEY"
```

## Alcances

Una clave solo llama a las rutas que permiten sus alcances. Elige el conjunto más pequeño que necesite la integración.

| Alcance | Permite |
| --- | --- |
| `read` | Listar y leer vídeos, carpetas, etiquetas y la configuración del reproductor |
| `write` | Crear, actualizar, eliminar, subir y publicar esos mismos recursos |
| `analytics` | Rutas de analítica bajo `/v1/analytics` |
| `webhooks` | Crear y administrar endpoints de webhook |
| `admin` | Administración del espacio. Déjalo fuera de una clave de integración |

Las rutas `GET` de vídeos, carpetas, etiquetas y reproductores necesitan `read`. `POST`, `PATCH`, `PUT` y `DELETE` sobre esos recursos necesitan `write`. La analítica necesita `analytics` aunque el método sea `GET`. Los webhooks necesitan `webhooks` en todos los métodos.

Una clave ausente o revocada responde `401`. Una clave válida sin el alcance responde `403`.

## Las claves se administran con una sesión

Crear, listar, actualizar y revocar claves usa la sesión del panel, no una clave de API. Esas rutas están en `/v1/workspaces/{workspaceId}/api-keys`. Una clave de API no puede crear otra clave.

Revocar una clave tiene efecto en la siguiente solicitud.
