Laman utama / Pembangun / Orders API

Orders API

Tambah smm.guide ke panel anda sebagai pembekal. Setiap laluan yang anda bina dalam akaun anda ialah perkhidmatan dengan ID tersendiri: panel anda menghantar pesanan ke ID itu, dan laluan menyerahkannya kepada pembekal pertama anda yang boleh mengambilnya.

Tiga langkah

Formatnya sama seperti yang sudah digunakan oleh panel SMM sesama sendiri, jadi tiada apa-apa yang perlu diprogramkan.

1Bina laluanAkaun, Orders desk, Laluan. Pilih apa yang dihantarnya dan tambah sehingga lima perkhidmatan jenis itu daripada panel yang telah anda sambungkan.
2Cipta kunciOrders desk, Orders API. Kunci hanya ditunjukkan sekali. Anda boleh mengehadkannya kepada alamat pelayan panel anda.
3Tambah pembekal dalam panel andaURL API https://smm.guide/api/v2 dan kunci. Import perkhidmatan: laluan anda masuk bersama ID, harga dan hadnya.

Format permintaan

Kaedah HTTPPOST
URL APIhttps://smm.guide/api/v2
Badanapplication/x-www-form-urlencoded, atau JSON dengan Content-Type: application/json. A multipart/form-data badan juga dibaca, iaitu apa yang dihantar oleh PHP apabila cURL diberikan tatasusunan
JawapanJSON, sentiasa dengan HTTP 200, termasuk untuk badan yang tidak dapat kami baca atau permintaan yang terlalu besar. Ralat ialah {"error": "…"}
WangDolar AS. Harga adalah bagi setiap 1,000

Senarai perkhidmatan

Laluan anda yang boleh mengambil pesanan sekarang. Laluan yang dimatikan, atau yang semua langkahnya terkeluar, tidak disenaraikan.

ParameterPerihalan
keyKunci API anda
actionservices

Jawapan

[
  {
    "service": 85725095,
    "name": "TG views, main",
    "type": "Default",
    "category": "Telegram views",
    "rate": "0.0018",
    "min": "10",
    "max": "1000000",
    "refill": false,
    "cancel": true,
    "dripfeed": false
  }
]

rate ialah harga termahal antara langkah laluan yang mungkin mengambil pesanan, termasuk yang dilangkau buat masa ini (panel yang tidak berfungsi hari ini akan kembali esok), jadi pesanan tidak sekali-kali berharga lebih daripada harga yang diimport oleh panel anda. min dan max ialah julat terluas yang diliputi oleh langkah-langkah yang berfungsi secara keseluruhan; kuantiti yang hanya sesuai dengan sebahagian daripadanya akan pergi ke salah satu daripadanya. refill dan cancel bernilai true apabila setiap langkah tersebut menawarkannya.

Laluan yang dimatikan, atau tiada langkah yang boleh berfungsi, dikeluarkan daripada senarai ini sehingga ia kembali. Panel yang menyegerakkan perkhidmatannya secara automatik akan mematikan perkhidmatan itu di pihaknya untuk tempoh yang sama, dan itulah yang anda mahukan: pesanannya akan ditolak.

Tambah pesanan

ParameterPerihalan
keyKunci API anda
actionadd
serviceID laluan, lapan digit
linkPautan ke halaman, siaran atau profil
quantityKuantiti diperlukan

Jawapan

{
  "order": 23501
}

Tiada yang menerimanya

{
  "error": "No step of this route accepted the order. …"
}

Nombor pesanan kekal sama sepanjang hayat pesanan, tidak kira pembekal mana yang akhirnya menghantarnya. Laluan menerima pautan dan kuantiti; drip-feed, komen dan medan tambahan lain ditolak.

Status pesanan

ParameterPerihalan
keyKunci API anda
actionstatus
orderID pesanan

Jawapan

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ParameterPerihalan
keyKunci API anda
actionstatus
ordersID pesanan dipisahkan dengan koma, sehingga 100

Jawapan

{
  "23501": {
    "charge": "0.0045",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "99": { "error": "Incorrect order ID" }
}
StatusMaksud
PendingDiterima oleh pembekal dan belum dimulakan. Juga pesanan yang pembekalnya tidak memberi jawapan jelas: laluan berhenti di situ sehingga anda menyemaknya dalam akaun anda.
In progress, ProcessingPembekal sedang menghantarnya, atau pesanan sedang beralih ke langkah seterusnya.
CompletedDihantar sepenuhnya.
PartialDihantar sebahagian; remains ialah bahagian yang tidak dihantar. Ia mengira apa yang dihantar oleh setiap langkah: apabila satu langkah menghantar sebahagian dan selebihnya dibatalkan pada langkah seterusnya, pesanan itu Separa, bukan Dibatalkan. Pembekal memutuskan sama ada memulangkan baki caj.
CanceledTiada apa-apa dihantar, dan tiada langkah lain mengambil pesanan itu. charge menunjukkan jumlah yang masih dicaj, jika ada.

charge ialah jumlah yang dicaj oleh pembekal untuk pesanan ini, dalam dolar pada kadar hari pesanan dibuat. start_count datang daripada pembekal yang memulakannya.

Baki

smm.guide tidak memegang wang anda. Angka ini ialah jumlah baki anda di panel di sebalik laluan anda, dalam dolar.

ParameterPerihalan
keyKunci API anda
actionbalance

Jawapan

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

Batal

Dihantar kepada pembekal yang memegang pesanan sekarang, jika perkhidmatannya menawarkan pembatalan. Pesanan yang anda batalkan tidak sekali-kali dihantar ke langkah seterusnya.

ParameterPerihalan
keyKunci API anda
actioncancel
ordersID pesanan dipisahkan dengan koma, sehingga 100

Jawapan

[
  { "order": 23501, "cancel": 1 },
  { "order": 23502, "cancel": { "error": "The order is already finished" } }
]

Isi semula

Dihantar kepada pembekal yang menghantar pesanan. Isi semula membawa nombor pesanan itu sendiri.

ParameterPerihalan
keyKunci API anda
actionrefill
orderID pesanan. Atau orders: beberapa, dipisahkan dengan koma

Jawapan, satu pesanan

{ "refill": "23501" }

Jawapan, beberapa pesanan

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ParameterPerihalan
keyKunci API anda
actionrefill_status
refillID isi semula. Atau refills: beberapa, dipisahkan dengan koma

Jawapan

{ "status": "Completed" }

Apa yang dilakukan laluan terhadap pesanan

  • Langkah dicuba mengikut susunan anda, atau langkah termurah yang berfungsi dahulu. Anda memilihnya dalam laluan.
  • Langkah dilangkau apabila panelnya tidak menjawab, baki atau had hariannya tidak mencukupi untuk pesanan, kuantiti di luar julat yang diterimanya, harganya melebihi had yang anda tetapkan, atau pada harganya pesanan akan melebihi had harian laluan itu sendiri. Ia kembali dengan sendirinya.
  • Langkah terkeluar apabila perkhidmatannya meninggalkan senarai harga, atau panel mula menjual sesuatu yang lain di bawah ID yang sama. Langkah lain terus berfungsi, dan anda akan dimaklumkan.
  • Penolakan memindahkan pesanan ke langkah seterusnya. Apabila panel menjawab dan menolak, tiada caj dikenakan, jadi langkah seterusnya dicuba.
  • Tiada jawapan jelas menghentikannya. Tamat masa atau jawapan yang rosak tidak menyatakan sama ada pesanan itu wujud. Menghantarnya ke tempat lain boleh menyebabkan ia dihantar dan dicaj dua kali, jadi laluan berhenti dan anda menyemak pesanan itu dalam akaun anda.
  • Satu pesanan berjalan bagi setiap pautan. Semasa pesanan untuk sesuatu pautan sedang berjalan pada laluan, pesanan kedua untuk pautan yang sama ditolak, seperti yang dilakukan oleh pembekal sendiri.
  • Pembatalan sebelum penghantaran juga boleh diteruskan, jika anda menghidupkannya. Apa yang tidak dihantar oleh pesanan separa hanya diteruskan jika anda memintanya.

Ralat

RalatMaksudnya
Invalid API keyKunci salah, telah diganti atau dibatalkan.
This key is limited to certain addresses…Permintaan datang daripada alamat yang tiada dalam senarai kunci.
Incorrect requestTidak diketahui action.
Incorrect service IDTiada laluan anda yang mempunyai ID ini. Laluan yang anda padam mengekalkan nombornya, dan ia tidak sekali-kali diberikan kepada laluan lain.
Incorrect order IDTiada pesanan anda yang mempunyai nombor ini.
Link is required, Quantity is requiredMedan add tiada atau bukan nombor.
A route takes a link and a quantity onlyPermintaan membawa drip-feed, komen atau medan tambahan lain.
This route is switched offHidupkannya dalam akaun anda.
This route already has an order for this link…Tunggu sehingga pesanan yang sedang berjalan selesai.
No step of this route can take this order right now. …Setiap langkah dilangkau sebelum apa-apa dihantar. Teks menamakan setiap panel dan sebabnya.
No step of this route accepted the order. …Setiap langkah yang diminta telah menolak. Tiada caj dikenakan.
Too many requests…Melebihi had di bawah. Tunggu seminit.

Contoh

cURL

curl https://smm.guide/api/v2 \
  -d key=sgo_… \
  -d action=add \
  -d service=85725095 \
  -d link=https://t.me/channel/123 \
  -d quantity=1000

PHP

function smmguide(array $post) {
  $ch = curl_init('https://smm.guide/api/v2');
  curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query(
      ['key' => 'sgo_…'] + $post),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
  ]);
  $out = json_decode(curl_exec($ch), true);
  curl_close($ch);
  return $out;
}
$order = smmguide(['action' => 'add',
  'service' => 85725095,
  'link' => 'https://t.me/channel/123',
  'quantity' => 1000]);

Panggilan add dijawab dalam masa 30 saat, sentiasa. Laluan mungkin bertanya kepada beberapa pembekal satu demi satu; setiap pembekal mendapat baki masa tersebut, dan pembekal yang tidak sempat ditunggu tidak akan ditanya langsung. Jika pembekal terakhir yang ditanya belum menjawab apabila masa tamat, anda mendapat nombor pesanan dengan status Menunggu, dan laluan berhenti di situ sehingga jawapan diketahui. Kebanyakan pesanan dijawab dalam satu atau dua saat.

Had dan keselamatan

  • 300 permintaan seminit bagi setiap kunci, 120 daripadanya pesanan. Sehingga 100 ID pesanan dalam satu status panggilan.
  • Kunci hanya ditunjukkan sekali dan disimpan sebagai cap jari. Anda mahupun kami tidak boleh membacanya lagi. Menggantikannya akan mematikan kunci lama serta-merta.
  • Alamat yang dibenarkan. Senaraikan alamat pelayan panel anda dalam akaun anda dan kunci itu tidak akan berfungsi dari tempat lain.
  • ID laluan bukan rahsia dan tidak perlu dirahsiakan. Ia hanya berfungsi bersama kunci akaun yang memiliki laluan itu.
  • Had anda tetap terpakai. Had harian setiap panel, had harian laluan itu sendiri dan pesanan terbesarnya terpakai kepada pesanan yang tiba melalui API sama seperti pesanan yang anda buat secara manual.
  • Wang tidak sekali-kali melalui smm.guide. Setiap pesanan dibayar daripada baki anda di panel yang mengambilnya. Bayaran balik dan pertikaian kekal antara anda dan panel tersebut.

Mahu membaca katalog?

Panel, Trust Score dan harga langsung mempunyai API tersendiri, serta pelayan MCP untuk pembantu AI.