FollowerHQ
ÖzelliklerFiyatlandırmaDokümantasyonBlog
Giriş yapKayıt ol
Türkçe

Kullanıcı API'si (Public API v2)

Müşterilerinizin kendi yazılımlarından sipariş verdiği standart SMM API; Perfect Panel ile byte uyumlu.

Her panelin müşterileri standart SMM API v2 ile sipariş verebilir. Format sektörde yaygın olan Perfect Panel biçimiyle birebir aynıdır: mevcut entegrasyonlar, reseller yazılımları ve bayi panelleri değişiklik yapmadan bağlanır.

Bağlantı
Adres https://<panel-alan-adı>/api/v2
Yöntem POST
Gövde application/x-www-form-urlencoded
Kimlik key parametresi, müşteri anahtarını panelde Hesap sayfasından alır
Yanıt Her zaman HTTP 200 ve JSON; hata {"error": "..."} biçiminde

Müşterinin anahtarı yeniden üretildiğinde eskisi anında geçersiz olur. Anahtar ve IP başına hız sınırı vardır.

İşlemler

Her istek action parametresiyle işlemi seçer.

services: servis listesi

key=...&action=services

[
  { "service": 1042, "name": "Instagram Takipçi [Gerçek]", "type": "Default", "category": "Instagram", "rate": "45.00", "min": "100", "max": "10000", "refill": true, "cancel": false }
]

rate, 1.000 adet için panel para birimindedir. Paket tipi servislerde rate tüm paketin fiyatıdır ve min/max 1'dir.

add: sipariş oluşturma

Zorunlu alanlar servis tipine göre değişir:

Tip Parametreler
Default service, link, quantity (+ isteğe bağlı runs, interval, drip-feed)
Package service, link
Custom Comments service, link, comments (satır başına bir yorum)
Comment Likes service, link, quantity, username
Subscriptions service, username, min, max, delay (+ posts, old_posts, expiry) 
key=...&action=add&service=1042&link=https://instagram.com/kullanici&quantity=1000

{ "order": 5104 }

Bakiye yetersizse {"error": "Not enough funds on balance"} döner ve sipariş oluşmaz.

status: sipariş durumu

key=...&action=status&order=5104

{ "charge": "45.00", "start_count": "1250", "status": "In progress", "remains": "600", "currency": "TRY" }

Birden çok sipariş için orders=5104,5105,5106 (en fazla 100). Yanıt, sipariş numarasını anahtar olarak taşıyan bir nesnedir.

Durumlar: Pending, In progress, Processing, Completed, Partial, Canceled.

refill: telafi talebi

key=...&action=refill&order=5104          → { "refill": "17" }
key=...&action=refill&orders=5104,5105    → [ { "order": 5104, "refill": 17 }, { "order": 5105, "refill": { "error": "..." } } ]

refill_status

key=...&action=refill_status&refill=17    → { "status": "Completed" }

cancel: iptal talebi

key=...&action=cancel&orders=5104,5105    → [ { "order": 5104, "cancel": 1 }, { "order": 5105, "cancel": { "error": "Cancel not available" } } ]

balance

key=...&action=balance                    → { "balance": "1250.00", "currency": "TRY" }

Hata mesajları

Invalid API key · Incorrect request · Incorrect service ID · Incorrect link · Incorrect quantity · Incorrect username · Incorrect comments · Not enough funds on balance · Incorrect order ID · Too many order IDs · Refill not found · Cancel not available

Panel sahibi için notlar

  • Müşterilerinizin göreceği API sayfası panelinizde /api adresinde hazırdır; alan adınızla örnekler otomatik doldurulur.
  • Sağlayıcı olarak başka panellere bağlanmak isteyenler de bu API'yi kullanır, bayiniz kendi panelinde sizi "sağlayıcı" olarak eklerken adres olarak https://<panel-alan-adı>/api/v2 girer.