TikTok API Kurulumu
TikTok entegrasyonu için admin walkthrough. Son-kullanıcı akışı: Bağlantılar → TikTok.
Genel bakış
| Form alanı | Options anahtarı |
|---|---|
| Client Key | tiktok_client-key |
| Client Secret | tiktok_client-secret |
| Status | tiktok_integration_status |
ENV fallback: TIKTOK_CLIENT_KEY + TIKTOK_CLIENT_SECRET.
Alan adı "Client Key", "Client ID" değil
TikTok diğer portal'ların Client ID dediği şeye Client Key der. Sosyabot'un form etiketleri TikTok adlandırmasına uygundur.
developers.tiktok.com adım adım
1. Giriş yap ve geliştirici olarak kayıt ol
https://developers.tiktok.com → app'in sahibi olmasını istediğin TikTok hesabıyla giriş yap. Geliştirici şartlarını kabul et.
2. Yeni app oluştur
Manage apps → Connect an app. Doldur:
- App adı, icon, açıklama.
- App kategorisi (örn. Productivity, Social).
- Platform: Web.
- App website URL'i:
https://sosyabot.com.
3. Doğru ürünleri ekle
App'in içinde:
- Login Kit — OAuth için zorunlu.
- Content Posting API — video yayınlamak için zorunlu.
4. URL ayarlarını yapılandır
Login Kit ayarlarında:
- Redirect URIs:
https://app.sosyabot.com/api/v1/auth/tiktok/callback - Sosyabot Direct Post akışını kullanır (Inbox değil), ekstra redirect yok.
5. Scope'ları talep et
Gerekli OAuth scope'ları: user.info.basic, video.publish, video.upload. Sandbox app'lar davetli tester'lara bunları anında verir; production app'lar App Review gerektirir (TikTok screencast ve gizlilik/veri-işleme belgesi ister).
6. İncelemeye gönder (yalnızca production)
Sandbox testleri yeşil olduktan sonra app'i incelemeye gönder. Birkaç hafta sürebilir. Onaylanana kadar yalnızca davetli tester hesapları bağlanabilir.
7. Client Key + Client Secret'ı al
App dashboard → App credentials. Client Key ve Client Secret'ı kopyala.
Sosyabot admin paneline yapıştırma
/admin/api-integration/tiktok. Yapıştır, Enable, Save, Test credentials.
Hata: TikTok integration disabled: client key/secret not configured.
Doğrulama
/app/channels → Connect → TikTok → OAuth → onayla. /app/publishing'den 5–10 saniyelik bir mp4 dene.
Sorun giderme
| Belirti | Sebep | Çözüm |
|---|---|---|
TikTok integration disabled: client key/secret not configured | Admin + ENV boş | 1-7. adımlar. |
Connect başarılı ama yayın permission_error ile başarısız | App Sandbox kademesinde | Test hesabını Sandbox tester olarak davet et veya Production review'a gönder. |
Onay ekranında redirect_uri_mismatch | Redirect URI uyumsuz | Tam …/api/v1/auth/tiktok/callback ekle. |
Video yükleme video_size_too_large döner | Varlık TikTok limitlerini aşıyor | Doğrulanmamış hesaplar için TikTok ~287 MB / 60 sn'de sınırlar; güncel limitleri TikTok docs'ta kontrol et. |
ENV fallback
TIKTOK_CLIENT_KEY=<client key'in>
TIKTOK_CLIENT_SECRET=<client secret'in>.env düzenledikten sonra ./service.sh restart api.