AiVideoEditor
Ücretsiz başlayın
Menü

İ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

KapsamYetenek
accounts:readHesapları, yetenekleri ve TikTok ayarlarını inceleme
media:writeYüklemeleri ayırtma, sonlandırma ve yönetme
posts:readGönderileri listeleme, taslakları doğrulama ve durumu gözlemleme
posts:writeTaslak oluşturma ve düzenleme
posts:publishTeslimatları yayınlama, zamanlama, iptal etme ve yeniden deneme
usage:readÇalışma alanı kullanımını ve plan bilgisini okuma
webhooks:manageWebhook 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.