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.

1Buat ruteAkun, Orders desk, Rute. Pilih apa yang dikirimkannya dan tambahkan hingga lima layanan jenis tersebut dari panel yang sudah Anda hubungkan.
2Buat kunciOrders desk, Orders API. Kunci hanya ditampilkan sekali. Anda dapat membatasinya ke alamat server panel Anda.
3Tambahkan penyedia di panel AndaURL API https://smm.guide/api/v2 dan kuncinya. Impor layanan: rute Anda masuk beserta ID, harga, dan batasnya.

Format permintaan

Metode HTTPPOST
URL APIhttps://smm.guide/api/v2
Bodyapplication/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
ResponsJSON, selalu dengan HTTP 200, termasuk untuk body yang tidak bisa kami baca atau permintaan yang terlalu besar. Error berupa {"error": "…"}
UangDolar 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.

ParameterDeskripsi
keyKunci API Anda
actionservices

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

ParameterDeskripsi
keyKunci API Anda
actionadd
serviceID rute, delapan digit
linkTautan ke halaman, postingan, atau profil
quantityJumlah 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

ParameterDeskripsi
keyKunci API Anda
actionstatus
orderID pesanan

Respons

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ParameterDeskripsi
keyKunci API Anda
actionstatus
ordersID pesanan dipisahkan koma, maksimal 100

Respons

{
  "23501": {
    "charge": "0.0045",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "99": { "error": "Incorrect order ID" }
}
StatusArti
PendingDiterima 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, ProcessingPenyedia sedang mengirimkannya, atau pesanan sedang diteruskan ke langkah berikutnya.
CompletedTerkirim sepenuhnya.
PartialTerkirim 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.
CanceledTidak 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.

ParameterDeskripsi
keyKunci API Anda
actionbalance

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.

ParameterDeskripsi
keyKunci API Anda
actioncancel
ordersID 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.

ParameterDeskripsi
keyKunci API Anda
actionrefill
orderID pesanan. Atau orders: beberapa, dipisahkan dengan koma

Respons, satu pesanan

{ "refill": "23501" }

Respons, beberapa

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ParameterDeskripsi
keyKunci API Anda
actionrefill_status
refillID 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

ErrorArtinya
Invalid API keyKunci salah, sudah diganti, atau dicabut.
This key is limited to certain addresses…Permintaan berasal dari alamat yang tidak ada di daftar kunci.
Incorrect requestTidak diketahui action.
Incorrect service IDTidak ada rute Anda dengan ID ini. Rute yang Anda hapus tetap menyimpan nomornya, dan nomor itu tidak pernah diberikan ke rute lain.
Incorrect order IDTidak ada pesanan Anda dengan nomor ini.
Link is required, Quantity is requiredKolom add tidak ada atau bukan angka.
A route takes a link and a quantity onlyPermintaan memuat drip-feed, komentar, atau kolom tambahan lain.
This route is switched offAktifkan 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 status panggilan.
  • 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.