Revisionato 2026-11-10 · Versione API 2026-11-09 · Leggi Markdown
Autenticazione e product key
La UI, la REST API e l'adattatore MCP di AiVideoEditor condividono i servizi del workspace. I client API
usano una product key, non un token OAuth di un social network o una credenziale di database.
Crea le chiavi all'indirizzo /app/developers dopo aver effettuato l'accesso al workspace corretto. Copia
la chiave in chiaro pk_v1_… una sola volta e conservala in un secret manager o in un
ambiente locale protetto. AiVideoEditor conserva un hash e un prefisso di visualizzazione.
Inviare una chiave
curl --fail-with-body -sS \
-H "Authorization: Bearer $PUBLISHER_KEY" \
"$PUBLISHER_API_URL/api/v1/usage"
Usa HTTPS per un origin distribuito. Tieni le credenziali fuori da URL, source control, prompt di chat, screenshot e log. Gli upload diretti allo storage usano l'URL firmato restituito e i relativi header; non inoltrare la tua bearer key AiVideoEditor allo storage.
Scope e accesso agli account
| Scope | Capability |
|---|---|
accounts:read | Ispeziona account, capability e impostazioni TikTok |
media:write | Riserva, finalizza e gestisce gli upload |
posts:read | Elenca i post, valida le bozze e osserva lo stato |
posts:write | Crea e modifica bozze |
posts:publish | Pubblica, programma, annulla e riprova le consegne |
usage:read | Legge utilizzo e informazioni sul piano del workspace |
webhooks:manage | Registra, elenca e rimuove endpoint webhook |
Gli scope sono nomi esatti, non una gerarchia. Concedi solo quelli di cui l'integrazione ha bisogno.
Le chiavi possono anche limitare gli ID account accessibili. La membership del workspace, il ruolo
effettivo, le restrizioni degli account e lo stato del piano restano applicati. Una chiave con
posts:publish non ottiene automaticamente l'accesso in scrittura alle bozze.
Il set di scope predefinito della chiave omette posts:publish e webhooks:manage. Un agente
solo bozze può preparare lavoro da revisionare senza l'autorità per inviarlo. Le chiavi non possono
creare altre chiavi o modificare la fatturazione.
Revoca e recupero
Revoca una chiave compromessa nella UI sviluppatore. Esamina prima il conteggio dei job in sospeso:
la revoca mette in pausa il lavoro non inviato come requires_action; non elimina le bozze.
Crea una sostituta con accesso appropriato ed esamina il lavoro in sospeso prima di
riprendere. Non dare per scontato che la revoca possa richiamare un invio già effettuato all'esterno.
Un 401 significa che le credenziali sono assenti o non valide. Un 403 significa che l'attore
autenticato non ha permessi o accesso agli account. Ripetere insistentemente una delle due risposte
non risolve nulla. Vedi errori e recupero.