SMM Panel API Documentation

Ano ang SMM panel API?

Ang SMM panel API ay nagpapahintulot sa isang program na kunin ang listahan ng services, mag-order, at i-check ang order status at balance nang hindi dumadaan sa website. Sinusuportahan ng 4SNS PLUS ang standard SMM panel API v2 format na ginagamit ng maraming panel at bot, kaya gagana agad ang code na naikonekta mo na sa ibang panel kapag pinalitan mo ang URL at key.

Pareho ang presyo at balance sa API at sa website. Ang rate sa services response ay katumbas ng presyo kada 1,000 (US dollars) sa price list, at ang mga order na ginawa gamit ang add ay kinukuha sa balance mo gaya ng web orders at lumalabas din sa order history sa dashboard mo. Ang halagang ibinalik mula sa canceled o partial orders ay bumabalik sa parehong balance.

Basics

Request example

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

Paano makakuha ng API key?

Kapag na-credit na sa balance mo ang una mong top up, pwede ka nang gumawa ng API key mula sa API key menu sa dashboard mo. Isang beses lang ipinapakita ang key kapag ginawa mo ito, kaya itago ito sa ligtas na lugar. Kapag gumawa ka ng bagong key, agad na nade-disable ang dating key.

Hiwalay ang key sa account token mo. API key lang ang ilagay sa bot o server mo, hindi kailanman ang account token. Kung sa tingin mo ay na-expose ang key mo, gumawa lang ng bago sa API key screen.

Listahan ng services (services)

Ibinabalik ang lahat ng service na pwede mong i-order. Ang rate ay presyo kada 1,000 (USD), at kapag Package ang type, ito ang presyo ng isang package. Kapag Custom Comments ang type, magpapadala ka ng listahan ng comments imbes na dami. Ang category ay pangalan ng platform plus pangalan ng grupo.

Response example

[
  {
    "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
  }
]

Mag-add ng order (add)

Gumagawa ng order at kinukuha ang halaga sa balance mo. Ang halaga ay presyo kada 1,000 times dami; sa Package, ito ang presyo ng package, at sa Custom Comments, ang bilang ng comment lines ang dami. Available ang orders sa mga account na na-credit na ang unang top up. Ang order sa response ay ang order ID mo.

Response example

{
  "order": 31877
}

Order status (status)

Ang status ng isang order. Ang charge ay ang aktwal na binayaran pagkatapos ng refunds (USD, 6 decimals), ang start_count ay ang bilang noong nagsimula ang order, at ang remains ay ang dami na hindi pa naide-deliver.

Response example

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

Status ng maraming order (status, orders)

Nagche-check ng hanggang 100 orders nang sabay-sabay, na pinaghihiwalay ng comma ang order IDs. Ang IDs na hindi umiiral o wala sa account mo ay may error sa puwesto nila.

Response example

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

Mag-request ng refill (refill)

Para sa order ng service na may refill period na natapos bilang Completed o Partial, mag-request sa loob ng refill period na binibilang mula nang matapos ito. Bawat order ay pwedeng may isang open request, na may 24 oras na pagitan ng bawat request.

Response example

{
  "refill": 512
}

Refill status (refill_status)

Ang status ng isang refill request.

Response example

{
  "status": "Completed"
}

Balance (balance)

Ang balance mo (USD, 6 decimals).

Response example

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

Mga value ng order status

Mga value ng refill status

Mga error message

Ang errors ay dumarating bilang JSON na may error field sa HTTP 200 response. Sa code mo, i-check muna ang error field.

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

Paano ikonekta ang SMM panel API sa isang Telegram bot?