Dokumentasi API Panel SMM

Apa itu API panel SMM?

API panel SMM memungkinkan program mengambil daftar layanan, membuat pesanan, serta mengecek status pesanan dan saldo tanpa membuka website. 4SNS PLUS mendukung format API v2 panel SMM standar yang dipakai banyak panel dan bot, jadi kode yang sudah Anda hubungkan ke panel lain langsung berfungsi setelah Anda mengganti URL dan key.

Harga dan saldo di API sama dengan di website. Nilai rate di respons services sama dengan harga per 1,000 (dolar AS) di daftar harga, dan pesanan yang dibuat dengan add dipotong dari saldo Anda persis seperti pesanan web serta muncul di riwayat pesanan di dashboard. Dana dari pesanan yang dibatalkan atau parsial kembali ke saldo yang sama.

Dasar

Contoh request

curl -X POST https://4snsplus.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=balance

import requests

r = requests.post("https://4snsplus.com/api/v2", data={
    "key": "YOUR_API_KEY",
    "action": "add",
    "service": 2210,
    "link": "https://t.me/yourchannel",
    "quantity": 1000,
})
print(r.json())  # {"order": 31877} or {"error": "..."}

Bagaimana cara mendapatkan API key?

Setelah isi saldo pertama masuk ke saldo Anda, Anda bisa membuat API key dari menu API key di dashboard. Key hanya ditampilkan sekali saat dibuat, jadi simpan di tempat yang aman. Membuat key baru langsung menonaktifkan key sebelumnya.

Key ini terpisah dari token akun Anda. Masukkan hanya API key ke bot atau server Anda, jangan pernah token akun. Jika Anda merasa key Anda bocor, cukup buat key baru di layar API key.

Daftar layanan (services)

Mengembalikan semua layanan yang bisa Anda pesan. rate adalah harga per 1,000 (USD), dan jika type adalah Package, itu harga satu paket. Jika type adalah Custom Comments, Anda mengirim daftar komentar sebagai ganti jumlah. category adalah nama platform ditambah nama grup.

Contoh respons

[
  {
    "service": 2210,
    "name": "Members - 30 Days Non Drop - 30 Days Refill",
    "type": "Default",
    "category": "Telegram - Members (30 Days Non Drop)",
    "rate": "1.4300",
    "min": "100",
    "max": "50000",
    "refill": true,
    "cancel": false
  }
]

Membuat pesanan (add)

Membuat pesanan dan memotong jumlahnya dari saldo Anda. Jumlahnya adalah harga per 1,000 dikali kuantitas; untuk Package adalah harga paket, dan untuk Custom Comments jumlah baris komentar menjadi kuantitas. Pesanan tersedia untuk akun yang isi saldo pertamanya sudah masuk. Nilai order di respons adalah ID pesanan Anda.

Contoh respons

{
  "order": 31877
}

Status pesanan (status)

Status satu pesanan. charge adalah jumlah yang benar-benar dibayar setelah refund (USD, 6 desimal), start_count adalah jumlah saat pesanan dimulai, dan remains adalah kuantitas yang belum terkirim.

Contoh respons

{
  "charge": "1.430000",
  "start_count": "8120",
  "status": "In progress",
  "remains": "410",
  "currency": "USD"
}

Status banyak pesanan (status, orders)

Mengecek hingga 100 pesanan sekaligus, dengan ID pesanan dipisahkan koma. ID yang tidak ada atau bukan milik akun Anda mendapat error di posisinya.

Contoh respons

{
  "1": { "charge": "0.300000", "start_count": "120", "status": "Completed", "remains": "0", "currency": "USD" },
  "10": { "error": "Incorrect order ID" }
}

Meminta isi ulang (refill)

Untuk pesanan layanan dengan masa isi ulang yang berakhir sebagai Completed atau Partial, ajukan dalam masa isi ulang yang dihitung sejak pesanan selesai. Setiap pesanan bisa punya satu permintaan terbuka, dengan jeda 24 jam antar permintaan.

Contoh respons

{
  "refill": 512
}

Status isi ulang (refill_status)

Status satu permintaan isi ulang.

Contoh respons

{
  "status": "Completed"
}

Saldo (balance)

Saldo Anda (USD, 6 desimal).

Contoh respons

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

Nilai status pesanan

Nilai status isi ulang

Pesan error

Error dikirim sebagai JSON dengan field error di respons HTTP 200. Di kode Anda, cek field error lebih dulu.

{
  "error": "Not enough funds on balance"
}

Bagaimana cara menghubungkan API panel SMM ke bot Telegram?