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.
https://smm.guide/api/v2 dan kunci. Import perkhidmatan: laluan anda masuk bersama ID, harga dan hadnya.Format permintaan
| Kaedah HTTP | POST |
| URL API | https://smm.guide/api/v2 |
| Badan | application/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 |
| Jawapan | JSON, sentiasa dengan HTTP 200, termasuk untuk badan yang tidak dapat kami baca atau permintaan yang terlalu besar. Ralat ialah {"error": "…"} |
| Wang | Dolar 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.
| Parameter | Perihalan |
|---|---|
key | Kunci API anda |
action | services |
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
| Parameter | Perihalan |
|---|---|
key | Kunci API anda |
action | add |
service | ID laluan, lapan digit |
link | Pautan ke halaman, siaran atau profil |
quantity | Kuantiti 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
| Parameter | Perihalan |
|---|---|
key | Kunci API anda |
action | status |
order | ID pesanan |
Jawapan
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| Parameter | Perihalan |
|---|---|
key | Kunci API anda |
action | status |
orders | ID 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" }
}| Status | Maksud |
|---|---|
Pending | Diterima 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, Processing | Pembekal sedang menghantarnya, atau pesanan sedang beralih ke langkah seterusnya. |
Completed | Dihantar sepenuhnya. |
Partial | Dihantar 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. |
Canceled | Tiada 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.
| Parameter | Perihalan |
|---|---|
key | Kunci API anda |
action | balance |
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.
| Parameter | Perihalan |
|---|---|
key | Kunci API anda |
action | cancel |
orders | ID 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.
| Parameter | Perihalan |
|---|---|
key | Kunci API anda |
action | refill |
order | ID pesanan. Atau orders: beberapa, dipisahkan dengan koma |
Jawapan, satu pesanan
{ "refill": "23501" }
Jawapan, beberapa pesanan
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| Parameter | Perihalan |
|---|---|
key | Kunci API anda |
action | refill_status |
refill | ID 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
| Ralat | Maksudnya |
|---|---|
Invalid API key | Kunci salah, telah diganti atau dibatalkan. |
This key is limited to certain addresses… | Permintaan datang daripada alamat yang tiada dalam senarai kunci. |
Incorrect request | Tidak diketahui action. |
Incorrect service ID | Tiada laluan anda yang mempunyai ID ini. Laluan yang anda padam mengekalkan nombornya, dan ia tidak sekali-kali diberikan kepada laluan lain. |
Incorrect order ID | Tiada pesanan anda yang mempunyai nombor ini. |
Link is required, Quantity is required | Medan add tiada atau bukan nombor. |
A route takes a link and a quantity only | Permintaan membawa drip-feed, komen atau medan tambahan lain. |
This route is switched off | Hidupkannya 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
statuspanggilan. - 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.