API Dökümanı

API adresi	https://lambun.com/api/v2
HTTP yöntemi	POST
İstek biçimi	Form alanları (application/x-www-form-urlencoded)
Yanıt biçimi	JSON
API sürümü	v2

API'miz, SMM panelleri arasında standart olan PerfectPanel API v2 ile uyumludur. Bu standardı destekleyen bir paneli ya da hazır bir yazılımı, yukarıdaki adresi ve API anahtarınızı girerek doğrudan bağlayabilirsiniz.

Her istekte key (API anahtarınız) ve action (yapılacak işlem) alanları gönderilir. API anahtarınızı, giriş yaptıktan sonra kullanıcı panelindeki API Dökümanları sayfasında bulabilirsiniz.

Hatalar da HTTP 200 ile ve {"error": "..."} biçiminde döner; yanıtta error alanı olup olmadığını kontrol edin. Hata mesajlarının tamamı sayfanın sonundadır.

Örnek istek

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

Servis listesi

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

Örnek yanıt

[
    {
        "service": 1,
        "name": "Instagram Takipçi",
        "type": "Default",
        "category": "Instagram",
        "rate": "0.90",
        "min": "50",
        "max": "10000",
        "refill": false,
        "cancel": false,
        "dripfeed": true
    },
    {
        "service": 2,
        "name": "Facebook Beğeni",
        "type": "Default",
        "category": "Facebook",
        "rate": "8",
        "min": "10",
        "max": "1500",
        "refill": false,
        "cancel": false,
        "dripfeed": false
    }
]

Yalnızca satışa açık servisler listelenir. service sipariş verirken kullanacağınız servis numarasıdır. rate, 1000 adet için size özel fiyattır (TRY); min ve max tek siparişte verilebilecek en az ve en çok adettir. type Default (normal) ya da Subscriptions (abonelik), refill ve cancel her zaman false döner. dripfeed true ise bu servise runs ve interval ile damlatmalı sipariş verilebilir.

Yeni sipariş

Parametre	Açıklama
key	API anahtarınız
action	add
service	Servis numarası (servis listesindeki service)
link	İşlem yapılacak sayfanın bağlantısı ya da kullanıcı adı (en fazla 191 karakter)
quantity	Adet; servisin min ve max değerleri arasında bir tam sayı
runs	Damlatmalı sipariş: tur sayısı, 2 ile 1000 arasında bir tam sayı. dripfeed açık servislerde, interval ile birlikte gönderilir.
interval	Damlatmalı sipariş: iki tur arasındaki dakika, 1 ile 10080 arasında bir tam sayı. runs ile birlikte gönderilir.

Örnek yanıt

{
    "order": 23501
}

order sipariş numaranızdır; durumu bu numarayla sorgulanır. Sipariş tutarı bakiyenizden hemen düşülür. Damlatmalı sipariş için runs ve interval birlikte gönderilir (yalnızca dripfeed açık servislerde); bu durumda order ilk turun sipariş numarasıdır. Toplam tutar (tur fiyatı x runs) hemen düşülür; sonraki turlar ayrıca ücretlendirilmez ve interval dakika arayla sıraya girer.

Desteklenmeyen bir servise runs ya da interval gönderilirse sipariş alınmaz ve {"error": "Drip-feed is not available for this service"} döner.

Abonelik (Subscriptions): type Subscriptions olan servise link ve quantity yerine username (izlenecek hesabın kullanıcı adı), min ve max (her gönderi için en az ve en çok adet; servis sınırları içinde), posts (işlenecek en fazla yeni gönderi; zorunlu, sınırsız abonelik yoktur), old_posts (isteğe bağlı, mevcut gönderilerden işlenecek adet), delay (dakika: 0, 5, 10, 15, 20, 30, 40, 50, 60, 90, 120, 150, 180, 210, 240, 270, 300, 360, 420, 480, 540 ya da 600) ve expiry (isteğe bağlı, gg/aa/yyyy, bugünden sonra) gönderilir. Yanıt {"order": abonelik numarası} döner; bu numara bir sipariş numarası değildir ve 1000000001'den başlar.

Ücret farkı: PerfectPanel'den farklı olarak bu panelde abonelik, gönderi sayısı verilmeden açılamaz ve ücret (posts + old_posts) x max x fiyat / 1000 tutarında, abonelik açılırken hemen çekilir; aralık en çok adetten faturalanır. Abonelik tamamlandığında, süresi dolduğunda ya da iptal edildiğinde işlenmeyen gönderilerin tutarı iade edilir.

Abonelik hataları: {"error": "Posts is required (unlimited subscriptions are not available)"}, {"error": "Min less than minimal 10"}, {"error": "Max more than maximal 1000"}, {"error": "Incorrect delay"}, {"error": "Incorrect expiry date"}, {"error": "Incorrect username"}, {"error": "Incorrect posts"}.

Sipariş durumu

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

Abonelik numarasıyla sorgulanırsa yanıt sipariş yerine aboneliği anlatır: status (Active, Paused, Completed, Expired ya da Canceled), expiry (gg/aa/yyyy ya da boş), posts (işlenen gönderi sayısı) ve orders (bu aboneliğin gönderi siparişlerinin numaraları). Yalnızca kendi aboneliğiniz sorgulanabilir.

Örnek yanıt

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

charge net ücrettir: sipariş tutarı eksi iade edilen tutar (iade yoksa sipariş tutarının kendisi), start_count başlangıç sayısı, remains kalan adet, currency para birimidir. Yalnızca kendi siparişlerinizi sorgulayabilirsiniz.

Birden çok siparişin durumu

Parametre	Açıklama
key	API anahtarınız
action	status
orders	Virgülle ayrılmış sipariş numaraları (en fazla 100 adet)

Örnek yanıt

{
    "1": {
        "charge": "0.27819",
        "start_count": "3572",
        "status": "Partial",
        "remains": "157",
        "currency": "TRY"
    },
    "10": {
        "error": "Incorrect order ID"
    },
    "100": {
        "charge": "1.44219",
        "start_count": "234",
        "status": "In progress",
        "remains": "10",
        "currency": "TRY"
    }
}

Yanıt, gönderdiğiniz numaralarla anahtarlanmış bir nesnedir. Bulunamayan ya da size ait olmayan numaralar için error döner. 100'den fazla numara gönderilirse isteğin tamamı {"error": "Incorrect request"} ile reddedilir.

Bakiye

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

Örnek yanıt

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

Telafi (refill)

Telafi bu panelde API üzerinden henüz sunulmuyor. Bağlanan yazılımların bozulmaması için istekler standarttaki biçimde, hata mesajıyla yanıtlanır.

Parametre	Açıklama
key	API anahtarınız
action	refill
order	Sipariş numarası
orders	order yerine: virgülle ayrılmış sipariş numaraları (en fazla 100 adet)

Örnek yanıt (order ile)

{
    "error": "Refill is not available for this order"
}

Örnek yanıt (orders ile)

[
    {
        "order": 1,
        "refill": {
            "error": "Refill is not available for this order"
        }
    },
    {
        "order": 3,
        "refill": {
            "error": "Incorrect order ID"
        }
    }
]

Telafi durumu

Parametre	Açıklama
key	API anahtarınız
action	refill_status
refill	Telafi numarası
refills	refill yerine: virgülle ayrılmış telafi numaraları (en fazla 100 adet)

Örnek yanıt (refill ile)

{
    "error": "Refill not found"
}

Örnek yanıt (refills ile)

[
    {
        "refill": 1,
        "status": {
            "error": "Refill not found"
        }
    },
    {
        "refill": 2,
        "status": {
            "error": "Refill not found"
        }
    }
]

İptal

Sipariş iptali bu panelde API üzerinden henüz sunulmuyor; istekler standarttaki biçimde, hata mesajıyla yanıtlanır ve hiçbir sipariş iptal edilmez.

Parametre	Açıklama
key	API anahtarınız
action	cancel
orders	Virgülle ayrılmış sipariş numaraları (en fazla 100 adet)

Örnek yanıt

[
    {
        "order": 9,
        "cancel": {
            "error": "Incorrect order ID"
        }
    },
    {
        "order": 2,
        "cancel": {
            "error": "Cancel is not available for this order"
        }
    }
]

Sipariş durumları

status	Anlamı
Pending	Beklemede
Processing	İşleniyor
In progress	Devam ediyor
Completed	Tamamlandı
Partial	Kısmi
Canceled	İptal edildi
Refunded	İade edildi

Hata mesajları

error	Anlamı
Invalid API key	API anahtarı gönderilmedi, hatalı ya da hesabınız kapalı
Incorrect request	action eksik ya da bilinmiyor, zorunlu bir parametre eksik, adet tam sayı değil, runs ya da interval yalnızca birinden gönderildi ya da tek istekte 100'den fazla numara gönderildi
Incorrect service ID	Servis bulunamadı ya da satışa kapalı
Incorrect link	Bağlantı 191 karakterden uzun
Quantity less than minimal N	Adet, servisin en az sipariş adedinin (N) altında
Quantity more than maximal N	Adet, servisin en çok sipariş adedinin (N) üstünde
Not enough funds on balance	Bakiyeniz bu sipariş için yetersiz
Drip-feed is not available for this service	Servis damlatmalı siparişe açık değil; runs ve interval bu serviste kabul edilmez
Runs less than minimal 2	Tur sayısı 2'nin altında
Runs more than maximal 1000	Tur sayısı 1000'in üstünde
Interval less than minimal 1	Aralık 1 dakikadan kısa
Interval more than maximal 10080	Aralık 10080 dakikadan (bir hafta) uzun
Incorrect order ID	Sipariş bulunamadı ya da size ait değil
Refill is not available for this order	Telafi bu panelde API üzerinden sunulmuyor
Refill not found	Bu numarayla bir telafi yok
Cancel is not available for this order	İptal bu panelde API üzerinden sunulmuyor
Internal server error	Sunucuda beklenmeyen bir hata oluştu (HTTP 500). İsteğin sonucu belirsizdir; siparişi yeniden göndermeden önce bakiyenizi kontrol edin