Dokumentasi API Panel SMM

Apakah API panel SMM?

API panel SMM membolehkan program mendapatkan senarai perkhidmatan, membuat pesanan serta menyemak status pesanan dan baki tanpa melalui laman web. 4SNS PLUS menyokong format API v2 panel SMM standard yang digunakan oleh banyak panel dan bot, jadi kod yang sudah anda sambungkan ke panel lain terus berfungsi sebaik sahaja anda menukar URL dan key.

Harga dan baki API sama seperti di laman web. Nilai rate dalam respons services sama dengan harga setiap 1,000 (dolar AS) dalam senarai harga, dan pesanan yang dibuat dengan add ditolak daripada baki anda sama seperti pesanan web serta turut muncul dalam sejarah pesanan di papan pemuka anda. Jumlah yang dipulangkan daripada pesanan yang dibatalkan atau separa kembali ke baki yang sama.

Asas

Contoh permintaan

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": "..."}

Bagaimanakah cara mendapatkan API key?

Sebaik sahaja tambah nilai pertama anda dikreditkan ke baki, anda boleh mencipta API key daripada menu API key di papan pemuka. Key hanya dipaparkan sekali semasa dicipta, jadi simpan di tempat yang selamat. Mencipta key baharu terus menyahaktifkan key sebelumnya.

Key ini berasingan daripada token akaun anda. Letakkan hanya API key dalam bot atau pelayan anda, jangan sekali-kali token akaun. Jika anda rasa key anda terdedah, cipta sahaja key baharu pada skrin API key.

Senarai perkhidmatan (services)

Memulangkan setiap perkhidmatan yang boleh anda pesan. rate ialah harga setiap 1,000 (USD), dan apabila type ialah Package, ia ialah harga satu pakej. Apabila type ialah Custom Comments, anda menghantar senarai komen sebagai ganti kuantiti. category ialah nama platform dan nama kumpulan.

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
  }
]

Buat pesanan (add)

Membuat pesanan dan menolak jumlahnya daripada baki anda. Jumlahnya ialah harga setiap 1,000 darab kuantiti; bagi Package ia ialah harga pakej, dan bagi Custom Comments bilangan baris komen ialah kuantitinya. Pesanan tersedia untuk akaun yang tambah nilai pertamanya sudah dikreditkan. Nilai order dalam respons ialah ID pesanan anda.

Contoh respons

{
  "order": 31877
}

Status pesanan (status)

Status satu pesanan. charge ialah jumlah sebenar yang dibayar selepas bayaran balik (USD, 6 tempat perpuluhan), start_count ialah jumlah semasa pesanan bermula, dan remains ialah kuantiti yang belum dihantar.

Contoh respons

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

Status berbilang pesanan (status, orders)

Menyemak sehingga 100 pesanan serentak, dengan ID pesanan dipisahkan koma. ID yang tidak wujud atau bukan milik akaun anda mendapat ralat di tempatnya.

Contoh respons

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

Minta isi semula (refill)

Bagi pesanan perkhidmatan yang mempunyai tempoh isi semula dan berakhir sebagai Completed atau Partial, buat permintaan dalam tempoh isi semula yang dikira dari masa pesanan tamat. Setiap pesanan boleh mempunyai satu permintaan terbuka, dengan jarak 24 jam antara permintaan.

Contoh respons

{
  "refill": 512
}

Status isi semula (refill_status)

Status satu permintaan isi semula.

Contoh respons

{
  "status": "Completed"
}

Baki (balance)

Baki anda (USD, 6 tempat perpuluhan).

Contoh respons

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

Nilai status pesanan

Nilai status isi semula

Mesej ralat

Ralat dihantar sebagai JSON dengan medan error dalam respons HTTP 200. Dalam kod anda, semak medan error dahulu.

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

Bagaimanakah cara menyambungkan API panel SMM ke bot Telegram?