AiVideoEditor
Inizia gratis
Menù

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

ScopeCapability
accounts:readIspeziona account, capability e impostazioni TikTok
media:writeRiserva, finalizza e gestisce gli upload
posts:readElenca i post, valida le bozze e osserva lo stato
posts:writeCrea e modifica bozze
posts:publishPubblica, programma, annulla e riprova le consegne
usage:readLegge utilizzo e informazioni sul piano del workspace
webhooks:manageRegistra, 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.