İçeriğe geç
shareto

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

  1. 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_..."
  2. 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" } }
  3. 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.mp4
  4. Yayı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öntemYolNe yapar
GET/accountsBağlı hesapları listeler
GET/accounts/{id}Tek bir hesabı getirir
POST/accounts/connectBir platform için bağlantı oluşturur
DELETE/accounts/{id}Hesabın bağlantısını keser, planlanmış gönderilerini iptal eder
POST/uploadsBir dosya için tek kullanımlık yükleme izni verir
POST/postsGönderiyi hemen yayınlar ya da planlar
GET/posts?ids=a,bSon 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.