ShareTo API
Kendi kodunuzdan yayınlayın
Instagram, Facebook, YouTube, LinkedIn ve TikTok'ta hesap bağlamak, gönderi yayınlamak ya da planlamak için tek bir REST API. İstediğiniz kadar API anahtarı oluşturun.
Temel adreshttps://shareto.social/api/v1
Kimlik doğrulama
Ayarlar'daki API bölümünden bir anahtar oluşturun ve her istekte bearer token olarak gönderin. Anahtar sayısı sınırsızdır, her anahtar yalnız bir kez gösterilir ve istediğiniz an iptal edebilirsiniz.
curl https://shareto.social/api/v1/accounts \ -H "Authorization: Bearer st_live_..."Hesap bağlama
Bir bağlantı isteyin ve tarayıcıda açın ya da hesabın sahibine gönderin. Hesap sahibi platformda izin verir ve redirectUrl adresinize döner. Bağlantı 30 dakika geçerlidir.
curl -X POST https://shareto.social/api/v1/accounts/connect \ -H "Authorization: Bearer st_live_..." \ -H "Content-Type: application/json" \ -d '{ "platform": "tiktok", "redirectUrl": "https://example.com/done" }' # 201 { "data": { "url": "https://shareto.social/api/connect/tiktok?t=...", "expiresAt": "2026-11-10T10:30:00.000Z" } }Medya yükleme
Bir yükleme izni alın, dosyayı putUrl adresine PUT ile gönderin. Büyük videolar tus ile kaldığı yerden devam edebilir. Dönen url'i gönderide kullanın.
curl -X POST https://shareto.social/api/v1/uploads \ -H "Authorization: Bearer st_live_..." \ -H "Content-Type: application/json" \ -d '{ "filename": "launch.mp4", "contentType": "video/mp4" }' curl -X PUT "$PUT_URL" \ -H "Authorization: Bearer $UPLOAD_TOKEN" \ -H "Content-Type: video/mp4" \ --data-binary @launch.mp4Yayınla ya da planla
Metni, medyayı ve hesap kimliklerini gönderin. Hemen yayınlamak için scheduledAt'i boş bırakın, planlamak için ISO biçiminde bir zaman verin. Her hesabın durumu ayrı izlenir.
curl -X POST https://shareto.social/api/v1/posts \ -H "Authorization: Bearer st_live_..." \ -H "Content-Type: application/json" \ -d '{ "kind": "reel", "caption": "Behind the scenes", "media": [{ "url": "$MEDIA_URL", "type": "video" }], "accountIds": ["$ACCOUNT_ID"], "scheduledAt": "2026-11-12T09:00:00Z" }'
Uç noktalar
| Yöntem | Yol | Ne yapar |
|---|---|---|
| GET | /accounts | Bağlı hesapları listeler |
| GET | /accounts/{id} | Tek bir hesabı getirir |
| POST | /accounts/connect | Bir platform için bağlantı oluşturur |
| DELETE | /accounts/{id} | Hesabın bağlantısını keser, planlanmış gönderilerini iptal eder |
| POST | /uploads | Bir dosya için tek kullanımlık yükleme izni verir |
| POST | /posts | Gönderiyi hemen yayınlar ya da planlar |
| GET | /posts?ids=a,b | Son 50 gönderiyi ya da ids ile verdiklerinizi getirir |
| GET | /posts/{id} | Tek bir gönderiyi her hesabın durumuyla getirir |
| DELETE | /posts/{id} | Henüz yayına çıkmamış bir gönderiyi siler |
Bağlantı yolları
Hesap, uygulamaları platformlarca herkese açık paylaşım için onaylanmış ortak yayın API'si Zernio üzerinden ya da doğrudan ShareTo'nun kendi uygulamalarıyla bağlanır. connection alanına auto, zernio ya da direct yazın; auto her platform için doğru yolu seçer.
Hatalar
Hatalar message alanı olan JSON olarak döner: anahtar eksik ya da yanlışsa 401, kayıt çalışma alanınızda değilse 404, istek bir platform kuralını çiğniyorsa 422. Mesaj neyi değiştirmeniz gerektiğini söyler.
ShareTo özel betada. Çalışma alanı açmak için erişim isteyin.