Skip to main content
GET
/
api
/
v1
/
status
Check Status
curl --request GET \
  --url https://app.sosmednext.com/api/v1/status
Di dalam sistem panel SMM yang autopilot, sangat disarankan Anda untuk membangun skrip Cronjob yang berjalan setiap 5 - 15 menit dari server hosting panel Anda ke Endpoint ini untuk memeriksa konfirmasi laporan status terbaru dari Provider (kami). Sistem kami mendukung pengecekan status single (khusus cek 1 pesanan) maupun multiple (banyak barisan pesanan sekaligus, dengan limit maksimal pemeriksaan hingga 100 ID pesanan per 1 request HTTP untuk melindungi efisiensi beban server).

Query Parameters Inti

Anda harus memberikan salah satu bentuk dari parameter berikut di dalam kueri (order ATAU orders), jangan menggunakan keduanya.
api_key
string
required
Kunci API Anda (Jika tidak mem-parsing metode API dari header).
order
integer
Nomor ID Order Provider yang Anda pernah dapatkan/terima saat memilah hasil JSON eksekusi POST /order sebelumnya. Gunakan field integer ini untuk mengecek hanya 1 buah pesanan independen.
orders
string
Mencek perkembangan banyak status pesanan (Bulk cek) secara massal. Pisahkan antar ID String nya dengan tanda simbol koma (Misal: 1010,1011,1012). Batas limit toleransi maksimal 100 ID Provider dalam satu paket request.

Contoh Integrasi Single Order Status

Request Single (cURL)
curl -X GET -H "X-Api-Key: YOUR_API_KEY" "https://app.sosmednext.com/api/v1/status?order=9210"
Response Data Single
{
  "order": 9210,
  "invoice": "API1234567",
  "service": "Instagram Followers [Quality V1]",
  "charge": 15000.0,
  "status": "processing",
  "start_count": 0,
  "remains": 0,
  "currency": "IDR"
}

Contoh Integrasi Multiple Orders Status (Untuk Cronjob Bulk Auto)

Bagi siklus Cronjob update status skrip CMS Anda, kami amat merekomendasikan Multiple Orders agar pengecekan dikelompokkan ke pengiriman data muatan massal mengirimkan sampai dengan 100 deret ID sekaligus per antrian siklus agar sistem kueri panel web Anda tidak timeout/disconnect.
Request Multiple (cURL)
curl -X GET -H "X-Api-Key: YOUR_API_KEY" "https://app.sosmednext.com/api/v1/status?orders=9210,9211,9212"
Berbeda dengan respons data single yang mencetak properti tunggal, Struktur Response untuk mode multiple membalas formasi JSON Object Map Dictionary (di mana kunci / label datanya adalah string ID Order Provider).
Format Data Dictionary Multiple
{
  "9210": {
    "order": 9210,
    "invoice": "API1234567",
    "service": "Instagram Followers [Quality V1]",
    "charge": 15000.0,
    "status": "success",
    "start_count": 100,
    "remains": 0,
    "currency": "IDR"
  },
  "9211": {
    "order": 9211,
    "invoice": "API998877",
    "service": "TikTok Views Auto Fast",
    "charge": 500.0,
    "status": "processing",
    "start_count": 210,
    "remains": 0,
    "currency": "IDR"
  }
}

Kamus Penjelasan Indikator Status:

Anda perlu meng-if else tipe balasan status untuk disamaratakan pada algoritma sinkronisasi MySQL database/CMS di tempat server Reseller Web milik Anda:
Indikator Kode EnumDefinisi / Keterangan Respon di Back-End Provider
pendingBerhasil dicatat: Pesanan resmi masuk queue (antrean provider) dan segera dipersiapkan.
processingOperasi sedang berlangsung: Server sedang mensuplai jumlah ke tautan target.
successSelesai dan Rampung: Pesanan telah tuntas tersuplai sesuai target kuantitas yang ada.
error atau canceledOrderan tertolak / terhambat karena masalah limit / keliru data target / link dilarang publik / server sedang drop, maka mutasi refund akan dipotong sebagian / dikembalikan balancenya.
partialPesanan Selesai Setengah Jalan/Mentok: Target pesanan disuplai sebagian saldonya lalu terhenti atau dikembalikan parsial balance ke rekening balance user API.
Informasi metrik lainnya: Field start_count adalah jumlah pesanan asalan (follower lama / like lama bawaan asli target) yang sudah menempel di tautannya sewaktu panel baru distart injeksi. Field remains adalah volume sisa layanan pesanan yang urung dieksekusi mesin provider ketika terjadi error cancel/partial dalam transaksi.