API Dokümanı

Soru, sorun, görüş ve önerileriniz için bize İletişim Sayfası üzerinden ulaşabilirsiniz.

API v2 Genel Bilgi
Overview

Aşağıdaki endpoint'ler üzerinden bakiyenizi sorgulayabilir, sipariş oluşturabilir, sipariş durumunu kontrol edebilir veya servis listesini çekebilirsiniz. Her istek için geçerli bir key (API anahtarınız) gereklidir. API anahtarınıza, hesabınıza giriş yaptıktan sonra API Sayfası üzerinden erişebilirsiniz.

-Temel URL: https://wesosyal.com/api/v2

-Desteklenen Methodlar: GET(bazılarında) ve POST

-Tüm isteklerde GET/POST verisi olarak key parametresini ekleyin. (API keyinizi bu alana girin.)

-Hatalar tek alanlı döner: {"error":"Açıklama"}.

Servis Listesi (services)

Mevcut servisleri listeler.

Endpoint:
GET/POST https://wesosyal.com/api/v2?action=services&key=API_KEYINIZ
Örnek Yanıt:
[
  {
    "service": 123,
    "name": "Instagram Takipçi",
    "type": "Default",
    "category": "Instagram",
    "rate": "259900",
    "min": "100",
    "max": "10000",
    "refill": false,
    "cancel": true
  }
]
Bakiye Sorgulama (balance)

Güncel bakiyeniz döner.

Endpoint:
GET/POST https://wesosyal.com/api/v2?action=balance&key=API_KEYINIZ
Örnek Yanıt:
{
  "balance": "250.75",
  "currency": "TRY"
}
Sipariş Ekleme (add)

Belirttiğiniz hizmet için sipariş oluşturur.

Endpoint:
POST https://wesosyal.com/api/v2?action=add&key=API_KEYINIZ
Gerekli Parametreler:
  • service (int) – Servis ID
  • link (string) – Hedef URL
  • quantity (int) – Miktar (min/max kontrolü yapılır)
Opsiyonel Parametreler:
  • gender (string) – Cinsiyet seçimi. all (varsayılan) | male | female
  • per_day (int) – Görev kaç güne bölünecek? (örn. "10")
  • include (string) – Dahil et özelliği. Virgülle ayrılmış ID listesi (örn. "1,2,3") ya da tek bir ID (örn. "1") Daha fazla bilgi
  • exclude (string) – Hariç bırak özelliği. Virgülle ayrılmış ID listesi (örn. "4,5,6") ya da tek bir ID (örn. "4") Daha fazla bilgi
  • comments (string) – Özel yorum ekleyebilirsiniz. Çoklu özel yorumlar; array ile gönderilebilir ya da satır sonu ile ayrılır (\r\n veya \n) Daha fazla bilgi
Örnek İstek (POST JSON):
{
  "service": 123,
  "link": "https://instagram.com/example",
  "quantity": 500,
  "gender": "female",
  "per_day": 2,
  "include": "1,2,3",
  "exclude": "4,5",
  "comments": "Harika paylaşım!\nÇok beğendim"
}
Başarılı Yanıt:
{
  "order": 456
}
Hata Örnekleri:
{ "error": "Service ID is required" }
{ "error": "Quantity must be at least 100" }
{ "error": "Insufficient funds" }
Sipariş Ekleme (add) Ek Bilgiler
How it works
include (dahil et) string

Bir sipariş (görev) oluşturulduğunda, include ile verilen ID'lere ait görevleri daha önce yapmış kullanıcılar bu yeni görevi yapabilir.

Format: virgülle ayrılmış ID listesi veya tek ID
"include": "1,2,3" veya "include": "1"
  • Boş veya geçersiz gönderimde null kabul edilir.
  • Yinelenen ID’ler otomatik elenir (sistem içinde normalize edilir).
exclude (hariç bırak) string

exclude olarak verilen ID’lere ait görevleri daha önce yapmamış kullanıcılar bu görevi yapabilir. Aksi durumda görev görünmez.

Format: virgülle ayrılmış ID listesi veya tek ID
"exclude": "4,5,6" veya "exclude": "4"
  • Aynı ID hem include hem exclude içinde ise exclude önceliklidir.
comments (özel yorum) string

comments alanı, gönderilecek özel yorumların tamamını tek bir metin olarak alır. Her satır bir yorumdur.

Format Örneği 1: satır sonu ile ayrılır (\r\n veya \n)
"comments": "Harika paylaşım!\nÇok beğendim\nDevamını bekliyorum"
Format Örneği 2: array ile gönderilebilir
"comments": [ "Harika paylaşım!", "Çok beğendim", "Devamını bekliyorum" ]
  • Boş gönderimde null kabul edilir.
  • Aşırı uzun satırlar sistem tarafından kısaltılabilir.
Sipariş Durumu (status)

Tek veya çoklu sipariş durumu sorgular.

Endpoint:
GET/POST https://wesosyal.com/api/v2?action=status&key=API_KEYINIZ&order=...
Parametre:
  • order (string veya dizi) – Tek ID: "123" | Çoklu: "1,10,100" veya order[]=1&order[]=10
Tekli Yanıt Örneği:
{
  "charge": "23.45",
  "start_count": "100",
  "status": "In progress",
  "remains": "100",
  "currency": "TRY"
}
Çoklu Yanıt Örneği:
{
  "1": {
    "charge": "14.75",
    "start_count": "205",
    "status": "In progress",
    "remains": "50",
    "currency": "TRY"
  },
  "2": {
    "charge": "103.00",
    "start_count": "616",
    "status": "Completed",
    "remains": "20",
    "currency": "TRY"
  },
  "3": {
    "error": "Incorrect order ID"
  }
}
Durum Açıklamaları:
  • Pending → Moderatör onayı bekleniyor
  • In progress → Gönderim devam ediyor
  • Completed → Sorunsuz Tamamlandı
  • Rejected → Reddedildi (Tam İade)
  • Partial → Bir Kısmı Tamamlandı (Kısmi İade)
Hata Yanıtları

Hata durumunda tek alanlı JSON döner.

Örnekler:
{ "error": "Invalid API key" } // API key bulunamadı
{ "error": "Only GET and POST methods are supported" } // Yalnızca GET/POST methodları desteklenir
{ "error": "Missing required parameters: action and key" } // Gerekli olan action ve key parametreleri eksik