Dokumentasi API

Kirim key/action dalam body application/x-www-form-urlencoded atau JSON. Parameter URL ditolak. Production wajib HTTPS. GET tidak didukung. Contoh hanya placeholder.

curl -X POST 'https://smmvelox.com/api/v2' \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=add' \
  --data-urlencode 'service=123' \
  --data-urlencode 'link=https://example.com/post' \
  --data-urlencode 'quantity=1000' \
  --data-urlencode 'client_order_id=YOUR_UNIQUE_ORDER_ID' \
  --data-urlencode 'max_charge=11550'

Autentikasi kunci API

Rahasiakan key dan kirim hanya dalam body. Jangan taruh di URL, kode frontend, atau bagikan. Rotasi/pencabutan berlaku langsung. Akun harus aktif dan email terverifikasi.

Kirim kunci hanya melalui HTTPS dalam body POST, bukan di URL atau kode browser.

Harga dan pembayaran API selalu VND. USD di antarmuka hanya referensi.

V1 hanya Default dengan mapping/unit terverifikasi: rate adalah VND per 1.000 unit; charge = rate × quantity / 1.000. service adalah DV-ID internal; order string ID lokal stabil. Tanpa ID penyedia. Uang berupa string desimal presisi hingga 12 digit pecahan.

key=YOUR_API_KEY&action=services

[
  {
    "service": 123,
    "name": "Example",
    "desc": "",
    "type": "Default",
    "category": "Facebook",
    "platform": "facebook",
    "rate": "11550.000000000000",
    "rate_unit": "per_1000",
    "min": "100",
    "max": "100000",
    "refill": false,
    "cancel": false,
    "dripfeed": false,
    "currency": "VND"
  }
]

Harga dan pembayaran API selalu VND. USD di antarmuka hanya referensi.

key=YOUR_API_KEY&action=balance

{
  "balance": "100000.000000000001",
  "currency": "VND"
}

add memerlukan service integer positif, link http/https maksimal 2.000 karakter, quantity integer dalam min/max. price/rate/discount/currency/user_id/status/provider dan field lain ditolak. Batch status maksimal 100 ID.

key=YOUR_API_KEY&action=add&service=123&link=https://example.com/post&quantity=1000&client_order_id=YOUR_UNIQUE_ORDER_ID

{
  "order": "456"
}

Status Pending/Processing/In progress/Completed/Partial/Canceled berdasarkan bukti. Review/tidak jelas menjadi Pending dengan review_required=true. start_count/remains null tanpa bukti, bukan nol rekaan. charge memakai snapshot pembayaran.

key=YOUR_API_KEY&action=status&order=456

{
  "charge": "11550",
  "status": "Pending",
  "start_count": null,
  "remains": null,
  "currency": "VND",
  "review_required": false
}

Respons berupa objek berdasarkan ID; ID yang tidak ada memiliki error sendiri. Maksimal 100 ID.

key=YOUR_API_KEY&action=status&orders=456,999

{
  "456": {
    "charge": "11550",
    "status": "Pending",
    "start_count": null,
    "remains": null,
    "currency": "VND",
    "review_required": false
  },
  "999": {
    "error": "Incorrect order ID"
  }
}

Package/per_unit, custom comments, subscriptions, dripfeed belum didukung dan disembunyikan. cancel/refill/refill_status mengembalikan HTTP 400 Action is not supported tanpa perubahan status/refund otomatis. Semua flag false di V1.

key=YOUR_API_KEY&action=cancel

{
  "error": "Action is not supported"
}

Aturan pesanan dan status

Koneksi bisa terputus setelah pesanan diterima dan saldo terpotong. Timeout atau HTTP 503 tidak membuktikan permintaan belum diproses. Gunakan satu referensi unik untuk setiap pesanan.

1. Sebelum add pertama, buat client_order_id unik (atau idempotency_key) dan simpan bersama service, link, quantity serta max_charge yang dikirim.
2. Jika menerima order ID, simpan dan periksa lewat action=status dengan order. Jangan mengirim add baru hanya untuk memeriksa status.
3. Jika timeout atau respons hilang dan belum ada order ID, coba lagi hanya saat koneksi dan API siap. Kirim action=add, referensi, dan semua parameter persis seperti sebelumnya. Jangan buat referensi baru.
4. Jika percobaan ulang menghasilkan order ID, lacak dengan ID tersebut. Jika masih belum pasti, hentikan percobaan otomatis berulang dan hubungi dukungan dengan referensi (bukan API Key).

curl -X POST 'https://smmvelox.com/api/v2' \
  --data-urlencode 'key=YOUR_API_KEY' \
  --data-urlencode 'action=add' \
  --data-urlencode 'service=123' \
  --data-urlencode 'link=https://example.com/post' \
  --data-urlencode 'quantity=1000' \
  --data-urlencode 'client_order_id=YOUR_UNIQUE_ORDER_ID' \
  --data-urlencode 'max_charge=11550'

action=status memerlukan order ID dan tidak menerima client_order_id. Tanpa order ID, ulangi add dengan data identik saat API siap, atau hubungi dukungan.

Contoh error JSON dan langkah penanganan

{
  "error": "Client order ID conflicts with an existing request"
}

{
  "error": "Invalid request parameters",
  "fields": [
    "quantity"
  ]
}

{
  "error": "Rate limit exceeded"
}

{
  "error": "API order creation is disabled"
}

JSON hanya contoh bentuk error yang berlaku; pesan error dapat berbeda menurut penyebab. Gunakan kode HTTP dan kondisinya sebagai acuan.

Kode status HTTP

Error berupa JSON dengan field error tanpa membocorkan detail internal.

Keamanan, batas dan error

Opsional: maksimal 20 alamat IPv4/IPv6 persis, satu per baris. Kosong berarti tanpa batas IP. CIDR tidak didukung. Daftar tidak valid ditolak tanpa mengubah pengaturan lama.

Per menit: 60 request/IP sebelum autentikasi; tambahan 120 baca atau 15 add per user/key. Body maksimal 64 KiB. 429 menyertakan Retry-After. Forwarded/X-Forwarded-For dari klien tidak dipercaya.

FAQ: Dapatkan key setelah masuk. Key hilang harus diganti; secret lama tidak dapat ditampilkan. Key penyedia tidak berlaku di sini. V1 (2026-10-30): services, balance, add Default dan status tunggal/batch. Purnajual menunggu alur aman V2.