İnceleme 2026-11-11 · API sürümü 2026-11-09 · Markdown oku
Yayınlama ve zamanlama
Bir AiVideoEditor gönderisi, sürümlendirilmiş bir taslak ve seçilen hesapları için bağımsız teslimatlardan oluşur. Taslak kaydetme esnektir; başarılı kaydetme, her hedefin yayınlanabilir olduğunu kanıtlamaz.
Bir gönderi hazırlama
- Amaçlanan anahtarla
/api/v1/accountsve/api/v1/capabilitiesuçlarını okuyun. - Gerekli medyayı yükleyin ve sonlandırın.
POST /api/v1/postsile bir taslak oluşturun veyaPATCH /api/v1/posts/{id}ile düzenleyin. Düzenlemelerde geçerliexpectedVersiondeğerini verin ve döndürülen sürümü saklayın.- Gerektiğinde hedef biçimini ve açık hesap başına varyant geçersiz kılmalarını ayarlayın. İstek alanlarını API başvurusu tanımlar.
POST /api/v1/posts/{id}/validateile doğrulayın. HTTP 200,valid: falseiçerebilir; göndermeden önce her sorunu inceleyin. Geçersiz hesaplar kitleden sessizce çıkarılmaz.
Şimdi veya sonra yayınlayın
POST /posts/{id}/publish, geçerli taslağı gönderir. POST /posts/{id}/schedule;
scheduledAt, timezone ve expectedVersion gerektirir. Zamanlanan an gelecekte
ve 90 gün içinde olmalıdır. Bir UTC ISO zaman damgası ve ayrı bir IANA görüntüleme
saat dilimi saklayın; göndermeden önce yaz saati uygulaması belirsizliklerini çözün.
Her yeni mutasyon için ayrı bir Idempotency-Key kullanın. Göndermeden önce o anahtarı
ve tam istek gövdesini saklayın. Bir zaman aşımından sonra özdeş isteği aynı
anahtarla yeniden gönderin. Anahtarı yalnızca kasıtlı olarak yeni bir işlem talep
ederken değiştirin. Bayat bir taslak düzenlemesi veya zamanlaması
revision_conflict döndürür; içeriği körlemesine üzerine yazmak yerine yeniden okuyun
ve inceleyin.
202 yanıtı gönderime kabul edildiği anlamına gelir. Yayınlama kanıtı değildir.
Teslim kimliklerini kaydedin ve GET /posts/{id} veya imzalı müşteri webhook'larını
gözlemleyin. Artan gecikmelerle sınırlı yoklama kullanın; sonsuz döngü yerine
sonlandırıcı sonuçlar veya insan devri için durun.
Hedef başına sonuçlar
Teslimatlar bağımsız sonuçlanabilir. Bir hedef yayımlanırken bir başkası yeniden
bağlantı veya onay gerektirebilir. Her durumu ve varsa yerel gönderi bağlantısını gösterin.
Yalnızca uygun bilinen bir başarısızlığı POST /deliveries/{id}/retry ile yeniden deneyin.
Başarılı hedefler, başarısız olanı kurtarmak için yeniden oluşturulmamalıdır. Bilinmeyen
bir harici sonuç, yeni bir gönderim değil mutabakat veya inceleme gerektirir.
İş güvenle talep edilmediği sürece POST /deliveries/{id}/cancel ile iptal edin.
too_late_to_cancel, gönderimin güvenli iptalin ötesine geçtiği anlamına gelir;
harici gönderinin kaldırıldığı anlamına gelmez.
TikTok insan incelemesi
Geçerli creator ayarları ve kullanılabilir gizlilik seçimleri için
/accounts/{id}/tiktok/settings uçlarını okuyun. Ayar okuması veya taslak kaydetme
onay sağlamaz. consent_required, kimlik doğrulamalı kompozitöre güvenli bir
requiresAction devri içerir. Yetkili bir kişi tam videoyu, paylaşım metnini ve hedefi
orada inceler ve gerekli seçimleri açıkça onaylar. Ürün anahtarları ve MCP araçları
adına onay veremez. İçerik veya kimlik değişiklikleri yeni inceleme gerektirir.
Devir, tek başına üyelik veya erişim vermez.
Kompozitör kontrolleri
Dosya yüklemek veya mevcut bir kitaplık öğesi seçmek için Add media düğmesini kullanın. Paylaşım metni, Customize content bir hesaba özgü varyant oluşturana kadar ortaktır. Emoji ve hashtag araçları imleçte düz metin ekler.
Posting options, seçili hesabın ayarlarını gruplar. Zorunlu seçimler görünür kalır; isteğe bağlı gruplar daraltılmış kalır. Değişiklikler yalnızca o hesaba uygulanır. Preview, etkin taslağı kaydetmeden veya göndermeden gösterir; eksik taslaklar dâhil. Yerel platform sunumu farklı olabilir.
Zamanlanmış kapaklar ve küçük resimler için özel varlık referansları kullanın. Genel URL alternatifleri teslim anında erişilebilir kalmalıdır. Altyazı içeriği geçici bir yerel dosyaya bağlı kalmak yerine değiştirilemez ayarlarla birlikte saklanır. LinkedIn belge yüklemesi şu anda PDF kabul eder; Office biçimleri imza doğrulaması uygulanana kadar kısıtlıdır.
Kurumsal kontroller ve entegrasyon sınırları için yetenekler başvurusuna bakın. Yeni biçim ve onay davranışı, dağıtımdan önce karşılık gelen veritabanı geçişlerini gerektirir.