REST API v2

Dokumentasi API

Integrasikan layanan HaloSMM ke sistem atau aplikasi Anda menggunakan REST API yang sederhana dan andal.

API Online

Base URL: https://halosmm.id/api/v2

💡 Butuh API key?

API key tersedia di menu Akses API pada akun panel master, bukan di child panel.

Overview

HaloSMM API memungkinkan Anda mengintegrasikan semua layanan HaloSMM ke platform Anda sendiri. API menggunakan metode POST dan mengembalikan response dalam format JSON.

Base URL

https://halosmm.id/api/v2

Metode Request

POST

Format Response

application/json

Response Error

Code	Deskripsi
error	Request tidak valid
Incorrect API key	API key salah atau tidak aktif
Not enough balance	Saldo tidak mencukupi
Minimum quantity	Jumlah di bawah minimum layanan
Maximum quantity	Jumlah melebihi batas maksimum
Service not found	ID layanan tidak ditemukan

Autentikasi

Setiap request ke API harus menyertakan parameter key berisi API key akun master Anda. API key dapat ditemukan di menu Akses API setelah login ke akun master.

REQUEST POST

POST https://halosmm.id/api/v2
Content-Type: application/x-www-form-urlencoded

key=YOUR_API_KEY&action=services

🔒 Keamanan API Key

• Jangan simpan API key di source code yang publik (GitHub, dll.)
• Gunakan environment variable untuk menyimpan API key
• Regenerasi API key jika dicurigai bocor melalui panel Anda

API key ini hanya berlaku untuk akun panel master. Child panel yang di-host berjalan melalui halaman web dan alur order internal, tanpa API key tersendiri.

Daftar Layanan

Endpoint ini mengembalikan daftar layanan beserta ID, harga, min/max, kategori, dan deskripsi. Field description kosong jika provider belum menyediakan deskripsi.

Parameter Request

Parameter	Nilai	Wajib
key	API Key Anda	Ya
action	`services`	Ya

Contoh Response

[
  {
    "service": 1,
    "name": "Instagram Followers | Real & Active | Refill 30 Hari",
    "description": "Followers aktif, refill tersedia selama 30 hari.",
    "type": "Default",
    "category": "Instagram - Followers",
    "rate": "0.85",
    "min": "50",
    "max": "500000",
    "refill": true,
    "cancel": false
  },
  {
    "service": 2,
    "name": "Instagram Likes | Max Unlimited | All Post | Fast Start",
    "description": "",
    "type": "Default",
    "category": "Instagram - Likes",
    "rate": "0.025",
    "min": "10",
    "max": "99999999",
    "refill": false,
    "cancel": false
  }
]

Buat Order

Endpoint ini digunakan untuk membuat order baru. Pastikan saldo mencukupi sebelum melakukan order.

Parameter Request

Parameter	Nilai	Wajib
key	API Key Anda	Ya
action	`add`	Ya
service	ID layanan	Ya
request_id	ID unik permintaan dari integrasi Anda untuk mencegah order ganda saat request diulang	Opsional

Pilih Service Type

Parameter	Nilai	Wajib
link	Link to page	Ya
quantity	Needed quantity	Ya
runs	Runs to deliver	Opsional
interval	Interval in minutes	Opsional

Parameter	Nilai	Wajib
link	Link to page	Ya

Parameter	Nilai	Wajib
link	Link to page	Ya
comments	Comments list separated by \r\n or \n	Ya

Parameter	Nilai	Wajib
link	Link to page	Ya
quantity	Needed quantity	Ya
username	Username of the comment owner	Ya

Parameter	Nilai	Wajib
link	Link to page	Ya
quantity	Needed quantity	Ya
answer_number	Answer number of the poll	Ya

Parameter	Nilai	Wajib
link	Link to page	Ya
username	Username	Ya
comments	Comments list separated by \r\n or \n	Ya

Parameter	Nilai	Wajib
username	Username	Ya
min	Quantity min	Ya
max	Quantity max	Ya
posts	Use this parameter if you want to limit the number of new (future) posts that will be parsed and for which orders will be created. If posts parameter is not set, the subscription will be created for an unlimited number of posts.	Opsional
old_posts	Number of existing posts that will be parsed and for which orders will be created, can be used if this option is available for the service.	Opsional
delay	Delay in minutes. Possible values: 0, 5, 10, 15, 20, 30, 40, 50, 60, 90, 120, 150, 180, 210, 240, 270, 300, 360, 420, 480, 540, 600	Ya
expiry	Expiry date. Format d/m/Y	Opsional

Contoh Response

{
  "order": 23501
}

Cek Status Order

Periksa status satu atau lebih order berdasarkan ID order yang dikembalikan saat membuat order.

Parameter Request

Parameter	Nilai	Wajib
key	API Key Anda	Ya
action	`status`	Ya
order	ID order	Ya

Contoh Response

{
  "charge": "0.85",
  "start_count": "3572",
  "status": "Partial",
  "remains": "157",
  "currency": "IDR"
}

Status Multiple

Cek status hingga 100 order sekaligus dengan memisahkan ID menggunakan koma.

Parameter Request

Parameter	Nilai	Wajib
key	API Key Anda	Ya
action	`status`	Ya
orders	ID order (pisah koma)	Ya

Contoh Response

{
  "1": {
    "charge": "0.27819",
    "start_count": "3572",
    "status": "Partial",
    "remains": "157",
    "currency": "IDR"
  },
  "10": {
    "error": "Incorrect order ID"
  }
}

Cek Saldo

Periksa saldo akun Anda saat ini melalui API.

Parameter Request

Parameter	Nilai	Wajib
key	API Key Anda	Ya
action	`balance`	Ya

Contoh Response

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

Child Panel yang Di-host

Child panel tersedia langsung di alamat /p/{slug} pada domain aplikasi ini. Pelanggan mendaftar, deposit, dan order lewat situs child panel. Order diteruskan ke provider melalui alur internal panel master; tidak ada API key atau endpoint API khusus child panel.

API pada halaman ini hanya untuk akun master dan menggunakan API key akun tersebut. Jangan membagikan API key master kepada pelanggan child panel.

Kelola Child Panel

Contoh Kode PHP

Contoh implementasi menggunakan PHP dengan cURL. Ganti YOUR_API_KEY dengan API key Anda.

<?php

define('API_URL', 'https://halosmm.id/api/v2');
define('API_KEY', 'YOUR_API_KEY');

function apiRequest(array $data): array {
    $data['key'] = API_KEY;
    $ch = curl_init(API_URL);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
    $result = curl_exec($ch);
    curl_close($ch);
    return json_decode($result, true);
}

// Cek saldo
$balance = apiRequest(['action' => 'balance']);
echo "Saldo: Rp " . number_format($balance['balance'], 0, ',', '.') . "\n";

// Daftar layanan
$services = apiRequest(['action' => 'services']);
echo "Total layanan: " . count($services) . "\n";

// Buat order
$order = apiRequest([
    'action'   => 'add',
    'service'  => 1,
    'link'     => 'https://instagram.com/example',
    'quantity' => 1000,
]);
echo "ID Order: " . $order['order'] . "\n";

// Cek status order
$status = apiRequest([
    'action' => 'status',
    'order'  => $order['order'],
]);
echo "Status: " . $status['status'] . "\n";

Contoh Kode Python

import requests

API_URL = 'https://halosmm.id/api/v2'
API_KEY = 'YOUR_API_KEY'

def api_request(data: dict) -> dict:
    data['key'] = API_KEY
    response = requests.post(API_URL, data=data)
    return response.json()

# Cek saldo
balance = api_request({'action': 'balance'})
print(f"Saldo: Rp {float(balance['balance']):,.0f}")

# Buat order
order = api_request({
    'action': 'add',
    'service': 1,
    'link': 'https://instagram.com/example',
    'quantity': 1000,
})
print(f"ID Order: {order['order']}")

Siap Mulai Integrasi?

Daftar akun, dapatkan API key, dan mulai integrasikan layanan HaloSMM dalam hitungan menit.

Daftar & Dapatkan API Key Hubungi Support