Dokumentasi API Resmi
My SMM Panel untuk Reseller

Pendahuluan

Selamat datang di Dokumentasi Resmi API My SMM Panel untuk Reseller.

API My SMM Panel memungkinkan Anda sebagai Reseller atau Developer untuk membangun panel SMM Anda sendiri dan mengintegrasikan layanan (services), melakukan pemesanan (orders), serta memeriksa status pesanan secara otomatis langsung ke dalam platform Anda.

Kami memfasilitasi integrasi tersebut dengan menyediakan REST API yang cepat, aman, dan mudah digunakan, dengan format pertukaran data standar yaitu JSON.

Base URL

Semua request atau permintaan ke API My SMM Panelmenggunakan metode HTTP standar dan diarahkan secara penuh ke Base URL berikut:

/api/v1

Fitur Utama API

Catatan Penting

• Semua Harga (Rate) yang ditampilkan dalam integrasi API kami adalah harga untuk nominal / kuantitas 1000 pesanan (quantity = 1000).
• Seluruh Response Format adalah dalam bentuk JSON Payload. Pastikan script integrasi sistem Anda mengirimkan header Content-Type: application/json.
• Apabila fitur keamanan API Whitelist Aktif pada pengaturan Anda, pastikan Alamat IP Publik (Public IP Range) dari Server Website / Panel Anda sudah terdaftar di Dashboard.

Autentikasi API

Cara mengotentikasi request API dari sistem/server Anda ke sistem My SMM Panel.

Setiap request yang dikirimkan ke endpoint API sistem My SMM Panel wajib menyertakan API Key Anda yang unik. API Key ini bertindak sebagai paspor akun Anda agar sistem kami dapat memproses order atas nama Anda dan menagih/memotong saldo pada nilai yang tepat secara algoritmik dari saldo Anda.

Anda dapat menemukan API Key saat ini, atau membuat API Key yang baru (me-reset) di halaman "Pengaturan Profil" dalam Dashboard My SMM Panel Anda.

Cara Mengirimkan API Key

Sistem kami mendukung 3 (tiga) cara berbeda untuk mengirimkan API Key pada setiap request Anda. Anda dapat memilih salah satu metode yang paling mudah diintegrasikan oleh library bahasa pemrograman / framework Anda.

1. Header X-Api-Key (Rekomendasi)

Pendekatan paling bersih adalah meletakkan key di Header Request custom, yaitu X-Api-Key.

curl -X GET -H "X-Api-Key: YOUR_API_KEY" /api/v1/balance

2. Header Authorization: Bearer

Jika sistem atau framework frontend/backend Anda sudah otomatis menggunakan skema Bearer token untuk authorization, Anda bisa memakainya.

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" /api/v1/balance

3. Query Parameter api_key

Jika framework Anda tidak mengizinkan kustom HTTP Header (yang terjadi di beberapa sistem web lawas), Anda dapat meletakkannya langsung di URL query string.

curl -X GET "/api/v1/balance?api_key=YOUR_API_KEY"

Memahami Response Error Authentication

Jika Anda mendapati konektivitas request tidak membuahkan hasil success, Anda kemungkinan menerima respons gagal pada HTTP code berikut karena berbagai alasan otentikasi. Jika API Key Anda keliru atau IP Server Anda belum didaftarkan (bila kontrol fitur IP Whitelist sedang ON), Anda akan menerima response HTTP 401 Unauthorized atau 403 Forbidden:

{
  "error": "Invalid API key or inactive account"
}

{
  "error": "IP not whitelisted"
}

Pastikan Anda menangkap exception code 400/401/403/500 pada logika try-catch aplikasi Anda untuk menampilkan pesan error dengan rapi alih-alih merusak antarmuka aplikasi.

API Reference

Dokumentasi lengkap My SMM Panel API v1 untuk integrasi panel SMM Anda.

Base URL

/api/v1

Autentikasi

Semua endpoint memerlukan API Key. Anda bisa mengirimkannya melalui:

• Header (Rekomendasi): X-Api-Key: YOUR_API_KEY
• Query Parameter: ?api_key=YOUR_API_KEY

curl -H "X-Api-Key: YOUR_API_KEY" "/api/v1/balance"

Endpoint yang Tersedia

Format Response

Semua response menggunakan format JSON. Response error akan selalu memiliki field error:

{
  "error": "Pesan error di sini"
}

Rate Limiting

Hindari mengirim request terlalu sering. Rekomendasi:

• Balance check: Maksimal 1x per menit
• Status check (cron): Setiap 5-15 menit
• Service sync: Setiap 24 jam

List Services (Layanan)

Mendapatkan daftar rekapitulasi lengkap dari semua layanan panel yang berstatus Active beserta hitungan biayanya (rate).

Anda dapat menggunakan endpoint canggih ini untuk mem-fetch atau mensinkronkan data katalog daftar layanan dari provider pusat sistem kami ke panel Anda. Dari sana, Anda dapat menaikkan harganya secara fleksibel (markup margin reseller di web aplikasi Anda), lalu menampilkan katalog yang bisa dibeli oleh pengguna panel Anda.

Sangat disarankan bagi panel aplikasi developer untuk men-setting rutinitas Cronjob sinkronisasi database Layanan secara otomatis setidaknya setiap 24 jam sekali atau seperlunya, karena perubahan pada id provider, status ketersediaan, update min/max order, dan harga (Rate Api) sangat mungkin berubah kapan saja.

Query Parameters

Contoh Request

curl -X GET -H "X-Api-Key: YOUR_API_KEY_HERE" "/api/v1/services"

Response Data Format

Respons JSON akan memberikan List/Array of Data Objects yang berisi seluruh objek layanan aktif yang memenuhi parameter query Anda.

[
  {
    "service": 1,
    "name": "Instagram Followers Terbaik [Quality S+]",
    "type": "Default",
    "category": "Instagram",
    "rate": 15000.0,
    "min": 100,
    "max": 50000,
    "refill": true,
    "description": "High quality followers. Garansi drop 30 hari.",
    "cancel": false
  },
  {
    "service": 2,
    "name": "TikTok Views Auto Fast Server V1",
    "type": "Default",
    "category": "TikTok",
    "rate": 500.0,
    "min": 1000,
    "max": 1000000,
    "refill": false,
    "description": "Masuk sangat instan. Cukup masukkan link Video.",
    "cancel": false
  }
]

Penjelasan Field

// Contoh logik di CMS Anda:
const TOTAL_HARGA_DASAR = (user_quantity / 1000) * provider_API_RATE;

// Tambahkan margin untuk cuan panel Anda, misal + Rp 3000
const TOTAL_DITAGIH_KE_USER = TOTAL_HARGA_DASAR + 3000;

Create Order

Melakukan pemesanan layanan dan sistem akan memotong saldo dari akun Anda otomatis.

Gunakan Endpoint ini ketika pelanggan pada Panel/Platform Anda menekan tombol "Buat Pesanan Baru". Sistem kami di backend akan secara cerdas memvalidasi id layanan, mengecek batasan server min/max, serta akan memotong saldo Anda secara otomatis sesuai harga API terbaik yang ditawarkan.

Body Parameters (JSON)

Endpoint ini membutuhkan tipe metode POST. Anda juga wajib memastikan Request Header memuat properti Content-Type: application/json.

Contoh Request

{
  "service": 12,
  "link": "https://instagram.com/user_client_1",
  "quantity": 1000
}

curl -X POST \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service":12, "link":"https://instagram.com/user_client_1","quantity":1000}' \
  "/api/v1/order"

Response

Jika validasi lolos dan sukses, saldo Anda akan terpotong secara otomatis.

{
  "order": 9210,
  "invoice": "API1024322",
  "service": 12,
  "link": "https://instagram.com/user_client_1",
  "quantity": 1000,
  "charge": 15000.0,
  "status": "pending",
  "currency": "IDR",
  "remains": 135000.0
}

Penjelasan Field

Troubleshooting

{
  "error": "Insufficient balance. Required: 8500.00, Available: 5000.00"
}

{
  "error": "Quantity must be between 100 and 50000"
}

Check Status

Mendapatkan pembaruan status real-time dari satu (single) atau beberapa pesanan (multiple) sekaligus.

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.

Sistem kami mendukung pengecekan status single (1 pesanan) maupun multiple (banyak pesanan sekaligus, dengan limit maksimal 100 ID pesanan per 1 request HTTP untuk efisiensi beban server).

Query Parameters

Anda harus memberikan salah satu dari parameter berikut (order ATAU orders), jangan menggunakan keduanya.

Single Order Status

curl -X GET -H "X-Api-Key: YOUR_API_KEY" "/api/v1/status?order=9210"

{
  "order": 9210,
  "invoice": "API1234567",
  "service": "Instagram Followers [Quality V1]",
  "charge": 15000.0,
  "status": "processing",
  "start_count": 0,
  "remains": 0,
  "currency": "IDR"
}

Multiple Orders Status

Untuk siklus Cronjob update status, kami amat merekomendasikan mode multiple agar pengecekan dikelompokkan ke pengiriman muatan massal hingga 100 ID per antrian agar sistem panel web Anda tidak timeout.

curl -X GET -H "X-Api-Key: YOUR_API_KEY" "/api/v1/status?orders=9210,9211,9212"

Berbeda dengan respons single, struktur response untuk mode multiple membalas formasi JSON Object Map Dictionary, di mana key-nya adalah string ID Order Provider.

{
  "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"
  }
}

Indikator Status

Field start_count adalah jumlah follower / like lama yang sudah ada di tautan target sewaktu panel baru di-start injeksi. Field remains adalah volume sisa layanan pesanan yang belum dieksekusi mesin provider ketika terjadi error/cancel/partial.

Check Balance

Melihat sisa saldo akun reseller Anda saat ini secara real-time.

Langkah pertama dalam integrasi biasanya adalah mengecek fungsionalitas dan saldo akun Anda. Endpoint ini mengembalikan sisa saldo (balance) Anda secara rinci, dan mata uang (currency) sistem yang sedang digunakan yaitu IDR.

Query Parameters

Contoh Request

curl -X GET -H "X-Api-Key: YOUR_API_KEY_HERE" "/api/v1/balance"

Response

{
  "balance": 150000.50,
  "currency": "IDR"
}

Create Refill

Mengajukan permintaan refill untuk pesanan yang memiliki garansi refill.

Gunakan endpoint ini untuk mengajukan refill pada pesanan yang sudah selesai namun mengalami penurunan (drop). Pastikan layanan yang dipesan memiliki properti refill: true pada daftar layanan.

Body Parameters (JSON)

Contoh Request (Single)

curl -X POST \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"order": 9210}' \
  "/api/v1/refill"

Response Single

{
  "refill": "1"
}

Contoh Request (Multiple)

curl -X POST \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orders": "9210,9211,9212"}' \
  "/api/v1/refill"

Response Multiple

[
  { "order": 9210, "refill": 1 },
  { "order": 9211, "refill": 2 },
  { "order": 9212, "refill": { "error": "Service does not support refill" } }
]

{
  "error": "Order not found"
}

Get Refill Status

Mengecek status permintaan refill yang sudah diajukan.

Setelah mengajukan refill melalui endpoint /api/v1/refill, gunakan endpoint ini untuk melacak status refill tersebut.

Query Parameters

Contoh Request

curl -X GET -H "X-Api-Key: YOUR_API_KEY" "/api/v1/refill_status?refill=1"

Response

{
  "status": "Completed"
}

{
  "error": "Refill not found"
}

Status Refill

Cancel Order

Membatalkan pesanan yang sedang berjalan dan mengembalikan saldo secara otomatis.

Gunakan endpoint ini untuk membatalkan satu atau beberapa pesanan yang masih dalam status pending atau processing. Saldo akan dikembalikan (refund) secara otomatis jika pembatalan berhasil diproses oleh provider.

Body Parameters (JSON)

Contoh Request

curl -X POST \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orders": "9210,9211"}' \
  "/api/v1/cancel"

Response

[
  { "order": 9210, "cancel": 1 },
  { "order": 9211, "cancel": { "error": "Order already success" } }
]

Kemungkinan Pesan Error

• Order not found — ID order tidak ditemukan atau bukan milik Anda.
• Order already success — Pesanan sudah selesai, tidak bisa dibatalkan.
• Order already canceled — Pesanan sudah dibatalkan sebelumnya.
• No provider data — Pesanan belum dikirim ke provider.