REST API v1 & Webhook Dokümantasyonu

Yazılımcılar ve Özel Entegrasyonlar İçin API Desteği

E-ticaret siteniz, WordPress/CMS panelleriniz, mobil uygulamanız veya özel ERP/CRM yazılımlarınızdan tek bir HTTP POST isteğiyle 17 farklı sosyal platforma görsel, video ve metin servis edin.

Temel API Adresi

https://sosyal.pivot.tr/api/v1

Kimlik Doğrulama

Authorization: Bearer <key>

İçerik Türü

application/json (UTF-8)

api.sosyal.pivot.tr

v1 REST API

POST /api/v1/paylasim

curl -X POST https://sosyal.pivot.tr/api/v1/paylasim \
  -H "Authorization: Bearer pivot_ak7x89q2m..." \
  -H "Content-Type: application/json" \
  -d '{
    "baslik": "Yeni ürünümüz satışta! 🚀",
    "medyaUrl": ["https://siteniz.com/urun.jpg"],
    "medyaTuru": "resim",
    "sablonId": "varsayilan",
    "reklamliDevamIzni": true,
    "hedefPlatformlar": [
      { "platformId": "instagram_id", "paylasimTipi": "post" },
      { "platformId": "facebook_id", "paylasimTipi": "post" },
      { "platformId": "twitter_id", "paylasimTipi": "tweet" }
    ]
  }'

Temel REST Uç Noktaları

POST

/api/v1/paylasim17 platforma tek seferde görsel ve metin dağıtır.

GET

/api/v1/krediÜcretsiz, ücretli bakiye ve Pivot İmzalı hakları sorgular.

GET

/api/v1/sablonlarHesaptaki dinamik görsel şablonlarını listeler.

POST

/api/webhook/:gizliAnahtarDış servislerden gelen verileri doğrudan paylaşıma dönüştürür.

Entegrasyon Kolaylıkları

Tek Yetkilendirme: Authorization: Bearer <anahtar> ile saniyeler içinde bağlanın.
Otomatik Boyutlandırma: Sistem süresine göre Reels / Shorts / Story ayrımını kendisi yapar.
Dinamik Şablonlama: Görselinize logonuzu ve kurumsal renk paletinizi sunucuda otomatik işler.
Atomik İade & Güvenlik: Gönderilemeyen platformlar için harcanan kredi anında iade edilir.

API & Webhook Desteklenen Parametreler

Parametre	Tip	Varsayilan	Açiklama
baslik	string	-	Gonderi veya video basligi.
icerik	string	-	Paylasim metni / aciklamasi.
medyaUrl	string[]	[]	Gorsel veya video URL dizisi (coklu galeri/carousel destekler).
medyaTuru	resim \| video \| metin	resim	Ana medya turu.
story	string \| boolean	"on" (otomatik acik)	Videolarda otomatik Instagram Story ve Facebook Sayfa Hikayesi paylasimini kapatmak icin `"off"` veya `false` gonderin.
sablonId	string	null	Gorsele uygulanacak dinamik sablon ID'si.
link	string	Otomatik (içerikten)	Hedef web sitesi veya haber linki. Facebook link paylaşımlarında veya önizlemelerde doğrudan kullanılır.
facebookSadeceLink	boolean \| number	false (veya panel ayarı)	Facebook için doğrudan link paylaşımı modu. `true` veya `1` gönderildiğinde Facebook şablon görseli oluşturmadan linki doğrudan paylaşır. Facebook sitenizdeki `og:image` etiketini çeker ve görsele tıklandığında ziyaretçiyi doğrudan sitenize yönlendirir. Başlık ve hashtag'ler gönderi metni olarak basılır.
hedefPlatformlar	array	Tum Bagli Platformlar	Ozel hedef platform listesi. Bos ise kullanicinin tum aktif hesaplarina gider.

Hemen API Anahtarınızı Alın ve Entegrasyona Başlayın

Pivot Sosyal yönetim panelinde API anahtarınızı tek tıkla üretebilir, yetkilendirme ve webhook ayarlarınızı hemen yapılandırabilirsiniz.