Beranda / Pengembang / Orders API
Orders API
Tambahkan smm.guide ke panel Anda sebagai penyedia. Setiap rute yang Anda buat di akun Anda adalah layanan dengan ID-nya sendiri: panel Anda mengirim pesanan ke ID tersebut, dan rute meneruskannya ke penyedia pertama Anda yang dapat menerimanya.
Tiga langkah
Formatnya sama dengan yang sudah digunakan antarpanel SMM, jadi tidak ada yang perlu diprogram.
https://smm.guide/api/v2 dan kuncinya. Impor layanan: rute Anda masuk beserta ID, harga, dan batasnya.Format permintaan
| Metode HTTP | POST |
| URL API | https://smm.guide/api/v2 |
| Body | application/x-www-form-urlencoded, atau JSON dengan Content-Type: application/json. A multipart/form-data body juga dibaca; inilah yang dikirim PHP saat cURL diberi array |
| Respons | JSON, selalu dengan HTTP 200, termasuk untuk body yang tidak bisa kami baca atau permintaan yang terlalu besar. Error berupa {"error": "…"} |
| Uang | Dolar AS. Harga per 1.000 |
Daftar layanan
Rute Anda yang bisa menerima pesanan saat ini. Rute yang dimatikan, atau yang semua langkahnya keluar, tidak dicantumkan.
| Parameter | Deskripsi |
|---|---|
key | Kunci API Anda |
action | services |
Respons
[
{
"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 adalah yang termahal di antara langkah rute yang mungkin menerima pesanan, termasuk yang sedang dilewati (panel yang down hari ini bisa kembali besok), sehingga pesanan tidak pernah lebih mahal dari harga yang diimpor panel Anda. min dan max adalah rentang terluas dari gabungan langkah yang berfungsi; jumlah yang hanya cocok untuk sebagian langkah dikirim ke salah satu langkah tersebut. refill dan cancel bernilai true jika setiap langkah tersebut menyediakannya.
Rute yang dimatikan, atau tidak memiliki langkah yang dapat berfungsi, tidak dicantumkan dalam daftar ini sampai kembali aktif. Panel yang menyinkronkan layanannya secara otomatis akan mematikan layanan itu di sisinya untuk waktu yang sama, dan memang itu yang Anda inginkan: pesanannya akan ditolak.
Tambah pesanan
| Parameter | Deskripsi |
|---|---|
key | Kunci API Anda |
action | add |
service | ID rute, delapan digit |
link | Tautan ke halaman, postingan, atau profil |
quantity | Jumlah yang dibutuhkan |
Respons
{
"order": 23501
}
Tidak ada yang menerima
{
"error": "No step of this route accepted the order. …"
}Nomor pesanan tetap sama sepanjang umur pesanan, penyedia mana pun yang akhirnya mengirimkannya. Rute menerima tautan dan jumlah; drip-feed, komentar, dan kolom tambahan lainnya ditolak.
Status pesanan
| Parameter | Deskripsi |
|---|---|
key | Kunci API Anda |
action | status |
order | ID pesanan |
Respons
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| Parameter | Deskripsi |
|---|---|
key | Kunci API Anda |
action | status |
orders | ID pesanan dipisahkan koma, maksimal 100 |
Respons
{
"23501": {
"charge": "0.0045",
"start_count": "3572",
"status": "Completed",
"remains": "0",
"currency": "USD"
},
"99": { "error": "Incorrect order ID" }
}| Status | Arti |
|---|---|
Pending | Diterima oleh penyedia dan belum dimulai. Juga pesanan yang tidak diberi jawaban jelas oleh penyedia: rute berhenti di situ sampai Anda memeriksanya di akun Anda. |
In progress, Processing | Penyedia sedang mengirimkannya, atau pesanan sedang diteruskan ke langkah berikutnya. |
Completed | Terkirim sepenuhnya. |
Partial | Terkirim sebagian; remains adalah bagian yang tidak terkirim. Nilai ini menghitung apa yang dikirim setiap langkah: jika satu langkah mengirim sebagian dan sisanya dibatalkan di langkah berikutnya, pesanan berstatus Partial, bukan Canceled. Penyedia yang memutuskan soal pengembalian sisa tagihan. |
Canceled | Tidak ada yang terkirim, dan tidak ada langkah lain yang menerima pesanan. charge menunjukkan berapa yang tetap ditagihkan, jika ada. |
charge adalah jumlah yang ditagihkan penyedia untuk pesanan ini, dalam dolar dengan kurs pada hari pesanan dibuat. start_count berasal dari penyedia yang memulainya.
Saldo
smm.guide tidak memegang uang Anda. Angka ini adalah jumlah saldo Anda di panel-panel di balik rute Anda, dalam dolar.
| Parameter | Deskripsi |
|---|---|
key | Kunci API Anda |
action | balance |
Respons
{
"balance": "126.1375",
"currency": "USD"
}Batal
Diteruskan ke penyedia yang saat ini memegang pesanan, jika layanannya menyediakan pembatalan. Pesanan yang Anda batalkan tidak pernah diteruskan ke langkah berikutnya.
| Parameter | Deskripsi |
|---|---|
key | Kunci API Anda |
action | cancel |
orders | ID pesanan dipisahkan koma, maksimal 100 |
Respons
[
{ "order": 23501, "cancel": 1 },
{ "order": 23502, "cancel": { "error": "The order is already finished" } }
]Refill
Diteruskan ke penyedia yang mengirimkan pesanan. Refill membawa nomor pesanan itu sendiri.
| Parameter | Deskripsi |
|---|---|
key | Kunci API Anda |
action | refill |
order | ID pesanan. Atau orders: beberapa, dipisahkan dengan koma |
Respons, satu pesanan
{ "refill": "23501" }
Respons, beberapa
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| Parameter | Deskripsi |
|---|---|
key | Kunci API Anda |
action | refill_status |
refill | ID refill. Atau refills: beberapa, dipisahkan dengan koma |
Respons
{ "status": "Completed" }Apa yang dilakukan rute terhadap pesanan
- Langkah dicoba sesuai urutan Anda, atau yang termurah dan berfungsi lebih dulu. Anda memilihnya di rute.
- Langkah dilewati jika panelnya tidak merespons, saldo atau batas hariannya tidak mencukupi pesanan, jumlahnya di luar yang diterima, harganya di atas batas yang Anda tetapkan, atau dengan harganya pesanan akan melampaui batas harian rute. Langkah itu kembali dengan sendirinya.
- Langkah keluar jika layanannya hilang dari daftar harga, atau panel mulai menjual hal lain dengan ID yang sama. Langkah lain tetap berjalan, dan Anda diberi tahu.
- Penolakan meneruskan pesanan. Jika panel menjawab dan menolak, tidak ada yang ditagih, sehingga langkah berikutnya dicoba.
- Tanpa jawaban jelas, rute berhenti. Timeout atau jawaban rusak tidak menunjukkan apakah pesanan itu ada. Meneruskannya bisa membuat pesanan terkirim dan ditagih dua kali, jadi rute berhenti dan Anda memeriksa pesanan itu di akun Anda.
- Satu pesanan berjalan per tautan. Selama pesanan untuk sebuah tautan masih berjalan di rute, pesanan kedua untuk tautan yang sama ditolak, seperti yang dilakukan penyedia sendiri.
- Pembatalan sebelum pengiriman juga bisa diteruskan, jika Anda mengaktifkannya. Sisa yang tidak terkirim dari pesanan sebagian hanya diteruskan jika Anda memintanya.
Error
| Error | Artinya |
|---|---|
Invalid API key | Kunci salah, sudah diganti, atau dicabut. |
This key is limited to certain addresses… | Permintaan berasal dari alamat yang tidak ada di daftar kunci. |
Incorrect request | Tidak diketahui action. |
Incorrect service ID | Tidak ada rute Anda dengan ID ini. Rute yang Anda hapus tetap menyimpan nomornya, dan nomor itu tidak pernah diberikan ke rute lain. |
Incorrect order ID | Tidak ada pesanan Anda dengan nomor ini. |
Link is required, Quantity is required | Kolom add tidak ada atau bukan angka. |
A route takes a link and a quantity only | Permintaan memuat drip-feed, komentar, atau kolom tambahan lain. |
This route is switched off | Aktifkan di akun Anda. |
This route already has an order for this link… | Tunggu sampai pesanan yang berjalan selesai. |
No step of this route can take this order right now. … | Semua langkah dilewati sebelum ada yang dikirim. Teksnya menyebut setiap panel beserta alasannya. |
No step of this route accepted the order. … | Semua langkah yang ditanya menolak. Tidak ada yang ditagih. |
Too many requests… | Melebihi batas di bawah. Tunggu satu menit. |
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]);
Permintaan add selalu dijawab dalam 30 detik. Rute dapat bertanya ke beberapa penyedia secara berurutan; masing-masing mendapat sisa waktu tersebut, dan penyedia yang tidak bisa ditunggu tidak ditanya sama sekali. Jika penyedia terakhir yang ditanya belum menjawab saat waktu habis, Anda mendapat nomor pesanan dengan status Pending, dan rute berhenti di situ sampai jawabannya diketahui. Sebagian besar pesanan dijawab dalam satu atau dua detik.
Batas dan keamanan
- 300 permintaan per menit per kunci, 120 di antaranya pesanan. Hingga 100 ID pesanan dalam satu
statuspanggilan. - Kunci hanya ditampilkan sekali dan disimpan sebagai sidik jari. Baik Anda maupun kami tidak dapat membacanya lagi. Menggantinya langsung menonaktifkan kunci lama.
- Alamat yang diizinkan. Cantumkan alamat server panel Anda di akun, dan kunci tidak akan berfungsi dari tempat lain.
- ID rute bukan rahasia dan tidak perlu dirahasiakan. ID itu hanya berfungsi bersama kunci akun pemilik rute.
- Batas Anda tetap berlaku. Batas harian setiap panel, batas harian rute, dan pesanan terbesarnya berlaku untuk pesanan yang masuk melalui API sama persis seperti pesanan yang Anda buat secara manual.
- Uang tidak pernah melewati smm.guide. Setiap pesanan dibayar dari saldo Anda di panel yang menerimanya. Pengembalian dana dan sengketa tetap menjadi urusan Anda dan panel tersebut.
Ingin membaca katalog?
Panel, Trust Score, dan harga terkini memiliki API tersendiri, serta server MCP untuk asisten.