API Dokümantasyonu

Başlarken

API adresi: /demo/sosyalpro/api/v2
Metod: POST
Format: application/x-www-form-urlencoded veya application/json
Yanıt: JSON

API anahtarınızı almak için hesabınıza giriş yapın.

Hizmet listesi

Parametre	Değer
`key`	API_ANAHTARINIZ
`action`	services

cURL

curl -X POST /demo/sosyalpro/api/v2 \
  -d "key=API_ANAHTARINIZ" \
  -d "action=services" \

Yanıt

[{"service":"12","name":"Instagram Takipçi | Türk | Garantili","type":"default","category":"Instagram — Takipçi","rate":"18.5000","min":"100","max":"50000","refill":true,"cancel":true,"dripfeed":true}]

Sipariş oluştur

Parametre	Değer
`key`	API_ANAHTARINIZ
`action`	add
`service`	12
`link`	https://instagram.com/kullaniciadi
`quantity`	1000

cURL

curl -X POST /demo/sosyalpro/api/v2 \
  -d "key=API_ANAHTARINIZ" \
  -d "action=add" \
  -d "service=12" \
  -d "link=https://instagram.com/kullaniciadi" \
  -d "quantity=1000" \

Yanıt

{"order":23501}

Kademeli teslim (dripfeed)

Kademeli teslimi destekleyen hizmetlerde sipariş, runs kadar parçaya bölünür ve her parça arasında interval dakika beklenir. Hizmetin bunu desteklediğini services yanıtındaki dripfeed alanından anlarsınız. Kurallar: runs 2 ile 100 arasında, interval 5 ile 1440 dakika arasında olmalı ve her parçaya düşen adet (quantity / runs) hizmetin min değerinden küçük olmamalıdır. Alanları hiç göndermezseniz sipariş tek seferde gönderilir.

Parametre	Değer
`key`	API_ANAHTARINIZ
`action`	add
`service`	12
`link`	https://instagram.com/kullaniciadi
`quantity`	1000
`runs`	5
`interval`	30

cURL

curl -X POST /demo/sosyalpro/api/v2 \
  -d "key=API_ANAHTARINIZ" \
  -d "action=add" \
  -d "service=12" \
  -d "link=https://instagram.com/kullaniciadi" \
  -d "quantity=1000" \
  -d "runs=5" \
  -d "interval=30" \

Yanıt

{"order":23502}

Özel yorum siparişi

Hizmet tipi "custom_comments" ise adet, gönderdiğiniz satır sayısından hesaplanır; quantity göndermenize gerek yoktur.

Parametre	Değer
`key`	API_ANAHTARINIZ
`action`	add
`service`	31
`link`	https://instagram.com/p/CxYz
`comments`	Harika paylaşım Eline sağlık

cURL

curl -X POST /demo/sosyalpro/api/v2 \
  -d "key=API_ANAHTARINIZ" \
  -d "action=add" \
  -d "service=31" \
  -d "link=https://instagram.com/p/CxYz" \
  -d "comments=Harika paylaşım
Eline sağlık" \

Yanıt

{"order":23503}

Sipariş durumu

Parametre	Değer
`key`	API_ANAHTARINIZ
`action`	status
`order`	23501

cURL

curl -X POST /demo/sosyalpro/api/v2 \
  -d "key=API_ANAHTARINIZ" \
  -d "action=status" \
  -d "order=23501" \

Yanıt

{"charge":"18.5000","start_count":"1450","status":"Completed","remains":"0","currency":"TRY"}

Toplu sipariş durumu

Parametre	Değer
`key`	API_ANAHTARINIZ
`action`	status
`orders`	23501,23502,23503

cURL

curl -X POST /demo/sosyalpro/api/v2 \
  -d "key=API_ANAHTARINIZ" \
  -d "action=status" \
  -d "orders=23501,23502,23503" \

Yanıt

{"23501":{"charge":"18.5000","status":"Completed","remains":"0"}}

Bakiye sorgulama

Parametre	Değer
`key`	API_ANAHTARINIZ
`action`	balance

cURL

curl -X POST /demo/sosyalpro/api/v2 \
  -d "key=API_ANAHTARINIZ" \
  -d "action=balance" \

Yanıt

{"balance":"1250.00","currency":"TRY"}

Telafi (refill) talebi

Parametre	Değer
`key`	API_ANAHTARINIZ
`action`	refill
`order`	23501

cURL

curl -X POST /demo/sosyalpro/api/v2 \
  -d "key=API_ANAHTARINIZ" \
  -d "action=refill" \
  -d "order=23501" \

Yanıt

{"refill":"1"}

Sipariş iptali

Parametre	Değer
`key`	API_ANAHTARINIZ
`action`	cancel
`orders`	23501,23502

cURL

curl -X POST /demo/sosyalpro/api/v2 \
  -d "key=API_ANAHTARINIZ" \
  -d "action=cancel" \
  -d "orders=23501,23502" \

Yanıt

[{"order":23501,"cancel":1}]

Sipariş durumu değerleri

status alanı bayi panellerinin beklediği standart sözlükle döner.

Değer	Anlamı
`Pending`	Sipariş alındı, sağlayıcıya henüz gönderilmedi.
`Processing`	Sağlayıcıya iletildi, başlaması bekleniyor.
`In progress`	Teslimat sürüyor; remains alanı teslim edilmeyi bekleyen adedi verir (henüz başlamamış siparişte tüm adet).
`Completed`	Tamamlandı, remains 0.
`Partial`	Kısmi teslim; teslim edilmeyen kısım iade edilir.
`Canceled`	İptal edildi veya başarısız oldu; ücret bakiyenize döner.
`Refunded`	Sipariş iade edildi.

Hata yanıtları

Hatalar HTTP 200 ile ve tek bir error alanıyla döner; istemcinizde önce error alanını kontrol edin.

Yanıt

{"error":"Geçersiz API anahtarı."}

Mesaj	Sebep
`Geçersiz API anahtarı.`	key parametresi eksik, hatalı veya anahtar yenilenmiş.
`Geçersiz işlem.`	action değeri desteklenmiyor.
`Hizmet bulunamadı.`	service kimliği yok ya da hizmet satışa kapalı.
`Sipariş bulunamadı.`	order/orders size ait değil veya silinmiş.
`Yetersiz bakiye.`	Bakiyeniz sipariş tutarını karşılamıyor.
`Bu hizmet için en az … adet sipariş verebilirsiniz.`	quantity hizmetin min değerinin altında.
`Bu hizmet için en fazla … adet sipariş verebilirsiniz.`	quantity hizmetin max değerinin üstünde.
`Bu hizmet damla teslimatı desteklemiyor.`	runs/interval gönderdiniz ama hizmetin dripfeed alanı false.
`Damla teslimat sefer sayısı 2 ile 100 arasında olmalıdır.`	runs sınırların dışında.
`Damla teslimat aralığı 5 ile 1.440 dakika arasında olmalıdır.`	interval sınırların dışında.
`Her seferde en az … adet düşmeli; sefer sayısını azaltın veya adedi arttırın.`	quantity / runs, hizmetin min değerinden küçük.
`Geçerli bir link veya kullanıcı adı girin.`	link boş ya da platformun beklediği biçimde değil.
`API kapalı.`	Yönetici bayi API'sini kapatmış.
`Çok fazla istek gönderdiniz. Lütfen bir dakika bekleyin.`	Dakikalık istek sınırı aşıldı.

Limitler ve ipuçları

Dakikada en fazla 120 istek gönderebilirsiniz; sınır IP başına uygulanır.
action=status ile tek çağrıda en fazla 100, action=cancel ile en fazla 50 sipariş sorgulanabilir.
action=services en fazla 500 hizmet döndürür; katalogu önbelleğe alıp 10-15 dakikada bir yenileyin.
Siparişler bakiyenizden düşer; bakiye yetersizse sipariş oluşmaz.
Anahtarınızı hesabınızdan yenilediğinizde eski anahtar anında geçersiz olur.