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.
Code
Code
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.