Cara Memakai API SMM Panel: Panduan dengan Contoh Kode (cURL, Python, PHP)

Cara Memakai API SMM Panel: Panduan dengan Contoh Kode#Tautan ke bagian Cara Memakai API SMM Panel: Panduan dengan Contoh Kode

API SMM panel memungkinkan program Anda memesan layanan dan memantau pesanan secara otomatis, tanpa membuka dashboard. API Instanizer memakai format SMM panel API v2, format standar yang dipakai banyak panel, jadi skrip atau panel reseller yang sudah ada bisa langsung terhubung. Artikel ini menunjukkan langkah dari awal sampai pesanan pertama, dengan contoh cURL, Python, dan PHP.

Belum tahu apa itu SMM panel? Baca dulu apa itu SMM panel. Untuk gambaran bisnisnya, lihat cara jadi reseller SMM panel.

Ringkasan teknis#Tautan ke bagian Ringkasan teknis

• URL: https://api.instanizer.com/api/v2
• Metode: POST
• Format body: application/x-www-form-urlencoded (disarankan), JSON, atau multipart/form-data
• Respons: JSON. Server selalu mengembalikan HTTP 200, jadi periksa isi respons: jika ada kunci error, permintaan gagal.
• Mata uang: Rupiah (IDR) untuk harga, tagihan, dan saldo.

Setiap permintaan wajib membawa parameter key (API key Anda) dan action (aksi yang diminta).

Langkah 1: buat API key#Tautan ke bagian Langkah 1: buat API key

Daftar atau masuk ke akun Instanizer, lalu buka menu API untuk membuat kunci. Kunci hanya ditampilkan sekali saat dibuat, jadi simpan di tempat yang aman dan jangan menaruhnya di kode yang dipublikasikan. Jika kunci bocor, cabut dan buat yang baru dari menu yang sama.

Isi juga saldo lewat menu Top Up, karena pesanan melalui API dibayar dari saldo yang sama dengan pemesanan lewat situs.

Langkah 2: ambil daftar layanan#Tautan ke bagian Langkah 2: ambil daftar layanan

curl -X POST https://api.instanizer.com/api/v2 \
  -d key=API_KEY_ANDA \
  -d action=services

Hasilnya daftar layanan dengan service (ID numerik yang stabil), name, category, rate (harga per 1.000 dalam Rupiah, persis seperti yang ditagihkan), min, max, serta penanda refill dan cancel. Gunakan ID service ini saat membuat pesanan. Layanan bisa ditambah atau dihapus dari katalog, jadi ambil ulang daftar ini secara berkala, misalnya sekali sehari, dan simpan di sisi Anda.

Langkah 3: buat pesanan#Tautan ke bagian Langkah 3: buat pesanan

curl -X POST https://api.instanizer.com/api/v2 \
  -d key=API_KEY_ANDA \
  -d action=add \
  -d service=1 \
  --data-urlencode link=https://instagram.com/username \
  -d quantity=1000 \
  -d idempotency_key=pesanan-0001

Respons sukses berisi ID pesanan, misalnya { "order": 23501 }. Untuk layanan bertipe Default, cukup service, link, dan quantity. Jumlah harus berada di antara min dan max layanan. Saldo dipotong saat pesanan dibuat.

Gunakan idempotency_key. Parameter ini opsional (1–64 karakter: huruf, angka, titik, garis bawah, titik dua, atau strip), tetapi sangat berguna. Jika koneksi terputus sebelum Anda menerima respons dan Anda mengirim ulang dengan kunci yang sama, sistem tidak membuat pesanan kedua dan mengembalikan ID pesanan pertama, sehingga Anda tidak tertagih dua kali.

Langkah 4: pantau status pesanan#Tautan ke bagian Langkah 4: pantau status pesanan

curl -X POST https://api.instanizer.com/api/v2 \
  -d key=API_KEY_ANDA \
  -d action=status \
  -d orders=23501,23502

Gunakan order untuk satu pesanan atau orders (dipisah koma, maksimal 100) untuk banyak sekaligus. Respons berisi charge (tagihan, sudah memperhitungkan refund), start_count, status, remains, dan currency. Nilai status yang mungkin: Pending, Processing, In progress, Completed, Partial, dan Canceled.

Status diperbarui dari penyedia sekitar setiap 10 menit, jadi memeriksa lebih sering tidak ada gunanya dan hanya menghabiskan batas permintaan Anda.

Langkah 5: refill, pembatalan, dan saldo#Tautan ke bagian Langkah 5: refill, pembatalan, dan saldo

• Refill (action=refill) meminta penggantian untuk pesanan berstatus Completed pada layanan yang mendukung refill. Satu pesanan hanya bisa diminta refill sekali per jeda (bawaan 24 jam). Pantau dengan action=refill_status.
• Pembatalan (action=cancel) meminta pembatalan ke penyedia. Jika diterima, saldo dikembalikan penuh. Penyedia dapat menolak pesanan yang sudah berjalan.
• Saldo (action=balance) menampilkan saldo akun Anda dalam Rupiah.

Penjelasan tentang istilah refill dan drop ada di apa itu drop dan refill.

Contoh kode Python#Tautan ke bagian Contoh kode Python

import requests

API_URL = "https://api.instanizer.com/api/v2"
API_KEY = "API_KEY_ANDA"


def call(**params):
    response = requests.post(API_URL, data={"key": API_KEY, **params}, timeout=60)
    return response.json()


order = call(
    action="add",
    service=1,
    link="https://instagram.com/username",
    quantity=1000,
    idempotency_key="pesanan-0001",
)

if "error" in order:
    print("Gagal:", order["error"])
else:
    status = call(action="status", order=order["order"])
    print(status["status"], "sisa:", status["remains"])

Contoh kode PHP#Tautan ke bagian Contoh kode PHP

<?php
function instanizer(array $params) {
    $params['key'] = 'API_KEY_ANDA';
    $ch = curl_init('https://api.instanizer.com/api/v2');
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => http_build_query($params),
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 60,
    ]);
    $body = curl_exec($ch);
    curl_close($ch);
    return json_decode($body, true);
}

$result = instanizer([
    'action' => 'add',
    'service' => 1,
    'link' => 'https://instagram.com/username',
    'quantity' => 1000,
    'idempotency_key' => 'pesanan-0001',
]);

if (isset($result['error'])) {
    echo 'Gagal: ' . $result['error'];
} else {
    echo 'Order ID: ' . $result['order'];
}

Menangani galat#Tautan ke bagian Menangani galat

Karena HTTP selalu 200, selalu cek kunci error. Beberapa pesan yang umum:

• Invalid API key: kunci salah, sudah dicabut, atau akun dinonaktifkan.
• Incorrect service ID: layanan tidak ada di katalog. Ambil ulang daftar layanan.
• Not enough funds on balance: saldo tidak cukup. Isi saldo lewat Top Up.
• Incorrect order ID: pesanan tidak ditemukan atau bukan milik akun Anda.
• Maximum 100 IDs per request: terlalu banyak ID dalam satu permintaan.
• Too many requests, please slow down: batas permintaan terlampaui; tunggu menit berikutnya lalu coba lagi.

Penolakan validasi atau penyedia (misalnya jumlah di bawah minimum) dikembalikan dengan pesan berbahasa Indonesia. Jika pesanan ditolak setelah saldo dipotong, saldo dikembalikan otomatis.

Batas permintaan#Tautan ke bagian Batas permintaan

• Sekitar 300 permintaan per menit untuk setiap API key, untuk semua action.
• 60 pesanan baru (add) per menit untuk setiap API key.
• Maksimal 100 ID per permintaan untuk status, refill, refill_status, dan cancel.
• Percobaan dengan key salah dibatasi per alamat IP; setelah melewati batas, IP tersebut diblokir sementara.

Gunakan status banyak sekaligus (orders) daripada memeriksa pesanan satu per satu.

Praktik yang baik#Tautan ke bagian Praktik yang baik

• Simpan daftar layanan di sisi Anda dan perbarui sekali sehari, jangan memanggil services untuk setiap pesanan.
• Selalu kirim idempotency_key pada add, dan buat kuncinya dari ID pesanan di sistem Anda sendiri.
• Periksa status per batch, tidak lebih sering dari sekitar 10 menit sekali.
• Catat ID pesanan, jumlah awal (start_count), dan waktu pemesanan untuk menangani keluhan pelanggan.
• Jangan pernah menaruh API key di kode sisi klien atau repositori publik.

Langkah berikutnya#Tautan ke bagian Langkah berikutnya

Dokumentasi lengkap dengan semua parameter tiap action ada di Dokumentasi API, dan ringkasan layanannya di halaman API SMM panel. Untuk menentukan harga jual, lihat daftar layanan dan harga. Siap mencoba? Daftar gratis dan buat API key pertama Anda. Instanizer tidak berafiliasi dengan platform media sosial mana pun.