API Belgeleri

Genel bakış

Toplistbot iki HTTP API'si sunar. İkisi de HTTPS üzerinden JSON kullanır ve aynı jeton bakiyesinden harcar — entegrasyon şeklinize uyanı seçin.

SMM panel API'si

Perfect Panel uyumlu tek bir uç nokta. Paneliniz standart SMM protokolünü zaten konuşuyorsa, buraya yönlendirin; kod değişikliği gerekmez.

Platform API'si

Kontrol panelinin arkasındaki REST API: site kataloğuna göz atın, oturum açın, kendi uygulamanızdan kampanya oluşturun ve yönetin.

Temel URL

Base URL

https://backend.toplistbot.com/api

Başlangıç

Yeni bir hesaptan çalışan bir kampanyaya beş adımda. Aşağıdakilerin tamamı en hızlı yol olan SMM uç noktasını kullanır; JWT aldıktan sonra platform API'si de aynı şekilde çalışır.

Hesap oluşturun
Kaydolun ve e-postanızı doğrulayın. Doğrulama, bakiyenize 100 ücretsiz jeton ekler; bu, hiçbir şey harcamadan gerçek bir kampanya yürütmenize yeter.
API anahtarınızı kopyalayın
Kontrol panelinizi açın ve bir API anahtarı oluşturun. Ona bir parola gibi davranın — jeton bakiyenizi harcar. İstediğiniz zaman yenileyebilirsiniz; bu, eskisini anında geçersiz kılar.
3
İstediğiniz hizmeti bulun
Sipariş verebileceğiniz tüm siteleri listeleyin. Her kayıtta sayısal bir hizmet kimliği ve 1.000 işlem başına jeton cinsinden bir oran bulunur. Tanıtım yapmak istediğiniz sitenin kimliğini not edin.
cURL
```
curl -X POST https://backend.toplistbot.com/api/v2 -d "key=YOUR_API_KEY" -d "action=services"
```
4
İlk siparişinizi verin
Hizmet kimliğini, kampanyanın çalışacağı URL'yi ve kaç işlem yürütüleceğini gönderin. Ücret anında düşülür ve yanıt size bir sipariş kimliği verir.
cURL
```
curl -X POST https://backend.toplistbot.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=9" \
  -d "link=https://arena-top100.com/index.php?a=in&u=yourserver" \
  -d "quantity=1000"
```
5
Teslimatı takip edin
Ne kadarının tamamlandığını görmek için sipariş kimliğini sorgulayın. Akıştan memnun kaldığınızda aynı çağrıları kendi panelinize veya betiklerinize bağlayın.
cURL
```
curl -X POST https://backend.toplistbot.com/api/v2 -d "key=YOUR_API_KEY" -d "action=status" -d "orders=184223"
```

Perfect Panel kurulumunu bağlama

Perfect Panel veya uyumlu SMM panel yazılımı kullanıyorsanız kod yazmanıza gerek yok — Toplistbot'u bu ayarlarla sağlayıcı olarak ekleyin ve hizmet listesini içe aktarın.

API URL'si: https://backend.toplistbot.com/api/v2
API anahtarı: YOUR_API_KEY
HTTP yöntemi: POST

Ölçeği büyütmeden önce bağlantı biçiminizin kabul edildiğini doğrulamak için tek bir sitede küçük bir miktarla başlayın. Hatalı bir bağlantı da jeton harcar.

Kimlik doğrulama

İki API farklı şekilde kimlik doğrular. SMM uç noktası uzun ömürlü bir API anahtarı kullanır; platform API'si ise oturum açarak aldığınız bir JWT kullanır.

API anahtarı (SMM uç noktası)

Anahtarınızı her istekte `key` alanı olarak gönderin — form alanı, sorgu parametresi ya da `Authorization: Bearer` başlığı olarak. Kontrol panelinizden oluşturup yenileyebilirsiniz. Aynı uç noktaya yapılan bir GET isteği ok durumu döndürür ve anahtarın geçerli olduğunu denetlemenin ucuz bir yoludur.

Health check

curl https://backend.toplistbot.com/api/v2?key=YOUR_API_KEY

JWT (platform API'si)

Bir jeton almak için oturum açın, ardından kimlik doğrulaması gereken uç noktalarda bunu bearer jetonu olarak gönderin. Jetonların süresi dolar — yenisini almak için /auth/refresh çağırın.

curl -X POST https://backend.toplistbot.com/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","password":"..."}'

Authenticated request

curl https://backend.toplistbot.com/api/orders/getAll \
  -H "Authorization: Bearer YOUR_JWT"

API anahtarınız gerçek jeton bakiyesi harcar. Sunucu tarafında tutun: tarayıcıya gönderilen ya da bir depoya işlenen her şey ele geçmiş sayılmalı ve kontrol panelinden yenilenmelidir.

Jetonlar ve fiyatlandırma

Kampanyalar önceden satın alınan jetonlarla ödenir. Her site bir oran yayımlar — orada 1.000 kampanya işlemi yürütmenin kaç jetona mal olduğu — services eyleminde `rate` olarak döner.

Cost formula

cost_in_tokens = (rate * quantity) / 1000

Oranı 13 olan bir site 1.000 işlem için 13 jetona mal olur; dolayısıyla 500'lük bir sipariş 6,5 jeton tutar. Ücret sipariş kabul edildiğinde düşülür ve iptal, harcanmayan kalanı iade eder.

balance ve status yanıtları Perfect Panel uyumluluğu için USD para birimi alanı bildirir, ancak değer dolar değil jeton bakiyesidir. Sayıyı jeton olarak değerlendirin.

SMM panel API'si

Her şeyi tek bir uç nokta yürütür. İşlemi seçmek için her POST isteğiyle bir `action` alanı gönderin; her istek ayrıca `key` değerinizi taşır.

POSThttps://backend.toplistbot.com/api/v2

Eylem	Parametreler
`services`	—
`add`	service, link, quantity, interval?
`status`	orders
`balance`	—
`cancel`	orders

`action=services`

Sipariş verebileceğiniz tüm siteleri, güncel oranları ve sınırlarıyla listeler. add çağrılarınızda `service` kimliğini kullanın.

cURL

curl -X POST https://backend.toplistbot.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services"

Response

[
  {
    "service": 9,
    "name": "arena-top100.com 1000 upvotes",
    "type": "Default",
    "category": "Votes",
    "rate": 15,
    "min": 1,
    "max": 50000,
    "refill": false,
    "cancel": true
  }
]

`rate`, 1.000 işlem başına jetondur. Her hizmet için `min` 1, `max` 50000'dir.

`action=add`

Bir kampanya oluşturur ve ücretini bakiyenizden anında düşer.

Parametre	Tür	Açıklama
`key`zorunlu	string	API anahtarınız.
`action`zorunlu	string	`add` olmalıdır.
`service`zorunlu	integer	services eyleminden gelen hizmet kimliği.
`link`zorunlu	url	Kampanyanın çalışacağı URL. Geçerli bir URL olmalıdır.
`quantity`zorunlu	integer	Yürütülecek işlem sayısı, 1 ile 50000 arasında.
`interval`	integer	Saat başına işlem. Varsayılan 15, üst sınır 4000 ve sitenin kendi azami değerini aşamaz.

cURL

curl -X POST https://backend.toplistbot.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=9" \
  -d "link=https://arena-top100.com/index.php?a=in&u=yourserver" \
  -d "quantity=1000" \
  -d "interval=60"

Response

{
  "order_id": 184223
}

`action=status`

Bir veya daha fazla siparişin ilerlemesini döndürür. Düz bir nesne için tek kimlik, ya da virgülle ayrılmış bir liste gönderin.

cURL

curl -X POST https://backend.toplistbot.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=status" \
  -d "orders=184223"

Response — single order

{
  "charge": 13.5,
  "start_count": 0,
  "status": "Completed",
  "remains": 1000,
  "currency": "USD"
}

Birden fazla kimlikte yanıt sipariş kimliğine göre anahtarlanır; bilinmeyen veya size ait olmayan siparişler tüm isteği başarısız kılmak yerine bir hata kaydı döndürür.

Response — multiple orders

{
  "184223": { "charge": 13.5, "start_count": 0, "status": "Completed", "remains": 1000, "currency": "USD" },
  "184224": { "error": "Incorrect order ID" }
}

`action=balance`

Kalan jeton bakiyenizi döndürür.

cURL

curl -X POST https://backend.toplistbot.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=balance"

Response

{
  "balance": 528.41,
  "currency": "USD"
}

`action=cancel`

Bir siparişi durdurur ve harcanmayan kalanı bakiyenize iade eder. Tamamlanmış siparişler iptal edilemez.

cURL

curl -X POST https://backend.toplistbot.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=cancel" \
  -d "orders=184223,184224"

Response

[
  { "order": "184223", "cancel": 1, "refund": 4.5 },
  { "order": "184224", "cancel": { "error": "Incorrect order ID" } }
]

Platform API'si

Kontrol panelinin kullandığı REST API'nin aynısı. Katalog uç noktaları herkese açıktır; diğer her şey JWT gerektirir.

Katalog

Herkese açık, kimlik doğrulama gerekmez. Kendi dizininizi veya fiyat sayfanızı oluşturmak için kullanışlıdır.

GET/orders/getAllWebsitesOranlar ve meta verilerle tüm listelenen siteler
POST/orders/getWebsiteDetailsByNameTam ada göre tek site
GET/orders/getAllBasicWebsitesDetailsRastgele 20 site adı
POST/products/getSuggestionsBir kimlik kümesi için ilgili siteler
GET/products/tokensMevcut jeton paketleri
POST/products/suggestEklememiz için bir site önerin
GET/news/timelineÜrün değişiklik günlüğü

cURL

curl https://backend.toplistbot.com/api/orders/getAllWebsites

Hesap

Kayıt, oturumlar ve fatura geçmişi.

POST/auth/registerHesap oluşturun
POST/auth/loginKimlik bilgilerini JWT ile değiştirin
POST/auth/refreshYeni bir JWT alın JWT
POST/auth/logoutGeçerli JWT'yi geçersiz kılın JWT
GET/auth/user-profileGeçerli kullanıcı profili JWT
POST/auth/reset-api-keyAPI anahtarınızı yenileyin JWT
GET/invoices/getFatura geçmişi JWT

Kampanyalar

Kampanya oluşturun, yönetin ve teslimat kayıtlarını okuyun.

GET/orders/getAllKampanyalarınız, en yeniden başlayarak
POST/orders/checkoutBir veya daha fazla kampanya oluşturun
POST/orders/updateBir kampanyayı düzenleyin
POST/orders/pauseÇalışan bir kampanyayı duraklatın
POST/orders/unpauseDuraklatılmış kampanyayı sürdürün
POST/orders/archiveBir kampanyayı arşivleyin
PATCH/orders/updateLimitGünlük üst sınırı değiştirin
GET/orders/logs/{id}Bir kampanyanın teslimat kaydı
GET/orders/graph/{id}Grafik için zaman serisi

Hatalar

Hatalar eşleşen bir HTTP durumuyla döner. Doğrulama hataları, alan adına göre anahtarlanan bir `errors` nesnesi döndürür.

400Geçersiz eylem, hatalı parametreler veya var olmayan bir hizmet kimliği.
401Eksik veya geçersiz kimlik bilgileri.
403Kimlik doğrulandı, ancak jeton bakiyeniz sipariş için yetersiz.
422İstek anlaşıldı ancak doğrulamadan geçemedi.

Validation error

{
  "errors": {
    "quantity": ["The quantity must be at least 1."]
  }
}

Sınırlar ve notlar

Sipariş miktarı 1 ile 50000 işlem arasında olmalıdır.
Aralık varsayılan olarak saatte 15'tir ve 4000 ile sınırlıdır. Bir sitenin kendi azami değerinden fazlası istenirse, sınırı belirten 400 hatasıyla reddedilir.
`refill` ve `refill_status` eylemleri uygulanmamıştır — bunun yerine yeni bir sipariş oluşturun.
`status` alanı henüz canlı bir ilerleme göstergesi değildir; teslimatı izlemek için `remains` ve `start_count` kullanın.
Liste siteleri kendi kurallarını belirler ve bunları zaman içinde değiştirir. Tanıtım yaptığınız her sitenin koşullarına uymaktan siz sorumlusunuz. Herhangi bir sıralama veya yerleşim vaat etmiyoruz.

Discord'da bize sorun

Genel bakış

SMM panel API'si

Platform API'si

Temel URL

Başlangıç

Hesap oluşturun

API anahtarınızı kopyalayın

İstediğiniz hizmeti bulun

İlk siparişinizi verin

Teslimatı takip edin

Perfect Panel kurulumunu bağlama

Kimlik doğrulama

API anahtarı (SMM uç noktası)

JWT (platform API'si)

Jetonlar ve fiyatlandırma

SMM panel API'si

`action=services`

`action=add`

`action=status`

`action=balance`

`action=cancel`

Platform API'si

Katalog

Hesap

Kampanyalar

Hatalar

Sınırlar ve notlar

Hemen Tanıtmaya Başlayın!