İnceleme 2026-11-10 · API sürümü 2026-11-09 · Markdown oku
Kimlik doğrulama ve ürün anahtarları
AiVideoEditor'ın UI'sı, REST API'si ve MCP bağdaştırıcısı çalışma alanı servislerini paylaşır.
API istemcileri sosyal ağ OAuth token'ı veya veritabanı kimlik bilgisi değil, ürün anahtarı
kullanır. Doğru çalışma alanında oturum açtıktan sonra /app/developers üzerinden
anahtar oluşturun. Düz metin pk_v1_… anahtarını bir kez kopyalayın ve bir sır
yöneticisinde veya korumalı yerel ortamda saklayın. AiVideoEditor bir karma ve görüntüleme
önekini saklar.
Anahtar gönderme
curl --fail-with-body -sS \
-H "Authorization: Bearer $PUBLISHER_KEY" \
"$PUBLISHER_API_URL/api/v1/usage"
Dağıtılmış bir kaynak için HTTPS kullanın. Kimlik bilgilerini URL'lerden, kaynak denetiminden, sohbet istemlerinden, ekran görüntülerinden ve günlüklerden uzak tutun. Doğrudan depolama yüklemeleri döndürülen imzalı URL'yi ve başlıkları kullanır; AiVideoEditor bearer anahtarınızı depolamaya iletmez.
Yetki kapsamları ve hesap erişimi
| Kapsam | Yetenek |
|---|---|
accounts:read | Hesapları, yetenekleri ve TikTok ayarlarını inceleme |
media:write | Yüklemeleri ayırtma, sonlandırma ve yönetme |
posts:read | Gönderileri listeleme, taslakları doğrulama ve durumu gözlemleme |
posts:write | Taslak oluşturma ve düzenleme |
posts:publish | Teslimatları yayınlama, zamanlama, iptal etme ve yeniden deneme |
usage:read | Çalışma alanı kullanımını ve plan bilgisini okuma |
webhooks:manage | Webhook uç noktalarını kaydetme, listeleme ve kaldırma |
Kapsamlar kesin adlardır, hiyerarşi değildir. Yalnızca entegrasyonun gereksinim
duyduklarını verin. Anahtarlar erişilebilir hesap kimliklerini de kısıtlayabilir. Çalışma
alanı üyeliği, etkin rol, hesap kısıtlamaları ve plan durumu yine de geçerlidir.
posts:publish içeren bir anahtar otomatik olarak taslak yazma erişimi kazanmaz.
Varsayılan anahtar kapsam seti posts:publish ve webhooks:manage içermez. Yalnızca
taslak amaçlı bir ajan, gönderme yetkisi olmadan inceleme için iş hazırlayabilir.
Anahtarlar başka anahtarlar oluşturamaz veya faturalamayı değiştiremez.
İptal ve kurtarma
Ele geçirilmiş bir anahtarı geliştirici arayüzünde iptal edin. Önce bekleyen iş
sayısını inceleyin: iptal, gönderilmemiş işleri requires_action olarak duraklatır;
taslakları silmez. Uygun erişime sahip bir yedek oluşturun ve devam etmeden önce
bekleyen işleri inceleyin. İptalin, zaten harici olarak gönderilmiş bir gönderiyi
geri çağırabileceğini varsaymayın.
401, kimlik bilgilerinin eksik veya geçersiz olduğu anlamına gelir. 403, kimliği
doğrulanmış tarafın izni veya hesap erişimi olmadığı anlamına gelir. Her iki yanıtı da
tekrar tekrar denemek sorunu çözmez. Hatalar ve kurtarmaya bakın.