API Dokümantasyonu

Kendi panelini, sitenı ya da botunu SosyalBurada altyapısına bağla. Standart SMM Panel API v2 sözleşmesini kullanıyoruz — başka bir panelde çalışan entegrasyonun burada da çalışır.

HTTP yöntemi	POST
API adresi	https://sosyalburada.com/api/v2
Yanıt biçimi	JSON
Para birimi	TRY

API anahtarın hesabında hazır. Giriş yap — anahtarın bu sayfada görünsün ve örnekler doğrudan çalışsın.

Servis listesi

Satışa açık tüm servisler, fiyatları ve sınırlarıyla. Bu listeyi kendi panelinde gösterirsin.

Parametre	Açıklama
key	API anahtarın
action	services

Örnek yanıt

[
    {
        "service": "12",
        "name": "Instagram Türk Takipçi",
        "type": "Default",
        "category": "Instagram Takipçi",
        "rate": "9.9000",
        "min": "50",
        "max": "100000",
        "refill": true,
        "cancel": true,
        "dripfeed": true
    }
]

Sipariş açma

Tutar bakiyenden düşer. Bakiye yetmezse sipariş açılmaz ve hata döner.

Parametre	Açıklama
key	API anahtarın
action	add
service	Servis ID (servis listesindeki service)
link	Link ya da kullanıcı adı
quantity	Adet
runs	(isteğe bağlı) Parça sayısı — drip-feed
interval	(isteğe bağlı) Parçalar arası dakika, 5–1440

Örnek yanıt

{
    "order": 23501
}

Sipariş durumu

Tek sipariş için order, en fazla 100 sipariş için orders kullan.

Parametre	Açıklama
key	API anahtarın
action	status
order	Sipariş ID

Örnek yanıt

{
    "charge": "9.9000",
    "start_count": "3572",
    "status": "Partial",
    "remains": "157",
    "currency": "TRY"
}

Çoklu sipariş durumu

En fazla 100 kimlik, virgülle ayrılmış. Bulunamayan kimlik kendi satırında hata döner — istek tamamen başarısız olmaz.

Parametre	Açıklama
key	API anahtarın
action	status
orders	Sipariş IDleri, virgülle ayrılmış (en fazla 100)

Örnek yanıt

{
    "1": {
        "charge": "9.9000",
        "start_count": "3572",
        "status": "Partial",
        "remains": "157",
        "currency": "TRY"
    },
    "10": {
        "error": "Incorrect order ID"
    }
}

Telafi talebi

Yalnızca telafi destekleyen servislerde ve tamamlanmış/kısmi siparişlerde. Aynı sipariş için açık talep varsa yenisi açılmaz, mevcut talebin kimliği döner.

Parametre	Açıklama
key	API anahtarın
action	refill
order	Sipariş ID
orders	(alternatif) Sipariş IDleri, virgülle ayrılmış

Örnek yanıt

{
    "refill": "1"
}

Telafi durumu

Telafi talebinin sağlayıcıya iletilip iletilmediğini gösterir.

Parametre	Açıklama
key	API anahtarın
action	refill_status
refill	Telafi ID
refills	(alternatif) Telafi IDleri, virgülle ayrılmış

Örnek yanıt

{
    "status": "Completed"
}

Sipariş iptali

Yalnızca başlamamış siparişler iptal edilir; tutar bakiyene iade edilir.

Parametre	Açıklama
key	API anahtarın
action	cancel
orders	Sipariş IDleri, virgülle ayrılmış (en fazla 100)

Örnek yanıt

[
    { "order": 2, "cancel": 1 },
    { "order": 9, "cancel": { "error": "Incorrect order ID" } }
]

Bakiye sorgulama

Hesabındaki kullanılabilir bakiye.

Parametre	Açıklama
key	API anahtarın
action	balance

Örnek yanıt

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

PHP örneği

Kopyala, anahtarını yaz, çalıştır. Başka kütüphane gerekmez.

<?php

function sbApi(array $veri) {
    $ch = curl_init('https://sosyalburada.com/api/v2');

    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => http_build_query($veri),
        CURLOPT_TIMEOUT        => 30,
    ]);

    $yanit = curl_exec($ch);
    curl_close($ch);

    return json_decode($yanit, true);
}

// Servis listesi
$servisler = sbApi([
    'key'    => 'API_ANAHTARIN',
    'action' => 'services',
]);

// Sipariş aç
$siparis = sbApi([
    'key'      => 'API_ANAHTARIN',
    'action'   => 'add',
    'service'  => 1,
    'link'     => 'https://instagram.com/kullaniciadi',
    'quantity' => 1000,
]);

// HER YANITTA HATA KONTROLÜ: `order` yoksa sipariş AÇILMAMIŞTIR.
// Kontrol etmezsen bakiyen bitmiş olsa bile "sipariş verdim" sanırsın.
if (isset($siparis['error'])) {
    exit('Hata: ' . $siparis['error']);
}

echo 'Sipariş no: ' . $siparis['order'];

Hata mesajları

Hata durumunda HTTP kodu yine 200 döner, gövdede error alanı bulunur — sektör standardı böyledir. Entegrasyonunda HTTP koduna değil bu alana bak.

Mesaj	Anlamı
Invalid API key	Anahtar yanlış ya da hesap askıya alınmış
Incorrect request	Tanınmayan action değeri
Invalid service	Servis bulunamadı ya da satışa kapalı
Not enough funds	Bakiye yetersiz
Incorrect order ID	Sipariş sana ait değil ya da yok
Incorrect order status	Sipariş bu işlem için uygun durumda değil
Refill not supported	Servis telafi desteklemiyor
Refill not found	Telafi talebi bulunamadı
Dripfeed is not supported for this service	Servis drip-feed desteklemiyor