# Introducción

La API de AtomicPlayer es una API JSON en `https://api.atomicplayer.ai`. Cubre lo mismo que el panel: vídeos, carpetas, etiquetas, configuración del reproductor, analítica y webhooks.

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

Una respuesta correcta tiene siempre la misma forma.

```json
{
  "success": true,
  "data": { "videos": [] },
  "error": null
}
```

## Qué puedes hacer

- Crear un vídeo, subir el archivo y esperar a que `status` sea `ready`.
- Organizar los vídeos con carpetas y etiquetas.
- Crear un reproductor, guardar un borrador y publicar la versión que sirve el embed.
- Leer reproducción, retención, audiencia e ingresos de un espacio de trabajo.
- Recibir webhooks firmados cuando alguien mira, termina, convierte, o cuando un vídeo queda listo.

Las rutas, los nombres de campo y los alcances siguen en inglés en todos los idiomas de este sitio.

## Siguiente paso

1. [Autenticación](/es/authentication) explica las claves, los alcances y las rutas que necesitan una sesión del panel.
2. [Solicitudes](/es/requests) cubre el sobre de respuesta, los errores y el cupo mensual.
3. [Webhooks](/es/webhooks) cubre el catálogo de eventos y cómo verificar una entrega.
4. La [referencia de la API](/es/api) lista cada ruta, con ejemplos de solicitud y respuesta.

El documento OpenAPI también está en [openapi.json](/openapi.json). Las copias en español y portugués son [openapi.es.json](/openapi.es.json) y [openapi.pt.json](/openapi.pt.json).
