API Reseller

Ikhtisar

Ini adalah antarmuka yang dikendalikan agen AI. Setiap panggilan adalah satu verb yang dipilih oleh action, sehingga agen mencari katalog, membaca kembali tarif dan batasan, lalu bertindak: cari-lalu-bertindak

API Reseller SocialGO mengikuti spesifikasi SMM API v2 yang diadopsi secara luas, sehingga perangkat lunak panel, skrip, dan integrasi yang sudah ada dapat berjalan dengan perubahan minimal. Setiap operasi melewati satu endpoint dan dipilih dengan parameter action.

Endpoint

POST https://api.socialgo.com/api/v2

Autentikasi

Autentikasi dilakukan per-permintaan. Kirim key rahasia Anda sebagai parameter pada setiap panggilan. Anda dapat menemukan dan merotasi key di dasbor pada bagian Akun → API. Perlakukan key seperti kata sandi dan jangan pernah menampilkannya di kode sisi klien.

Format permintaan

Permintaan dikirim sebagai parameter formulir application/x-www-form-urlencoded (metodenya selalu POST). Semua respons berupa JSON. Parameter umum yang ada pada setiap permintaan:

• key: API key Anda (wajib)
• action: operasi yang akan dijalankan (wajib)

Format kesalahan

Ketika sebuah permintaan gagal, respons berisi field error dengan pesan yang dapat dibaca manusia dan kode status HTTP mencerminkan masalahnya (mis. 400 permintaan tidak valid, 401 key tidak valid).

{
  "error": "Incorrect request"
}

Aksi

Setiap verb melakukan satu tugas. Agen merangkainya secara berurutan: services untuk menemukan apa yang akan dibeli, add untuk membelinya, status untuk melacaknya. Panggilan baca (services, status, balance) memungkinkan ia mengonfirmasi harga dan dana sebelum panggilan tulis (add, refill, cancel) membelanjakan apa pun.

1. Daftar layanan

Mengembalikan katalog lengkap layanan yang dapat Anda jual ulang, termasuk ID layanan, kategori, tarif (harga per 1000), dan kuantitas min/maks. Gunakan ID service yang dikembalikan saat membuat pesanan.

Permintaan

key=YOUR_API_KEY
action=services

Respons

[
  {
    "service": 1,
    "name": "Instagram Followers",
    "type": "Default",
    "category": "Instagram",
    "rate": "0.90",
    "min": "50",
    "max": "10000",
    "refill": true,
    "cancel": true
  },
  {
    "service": 2,
    "name": "Instagram Likes",
    "type": "Default",
    "category": "Instagram",
    "rate": "0.40",
    "min": "10",
    "max": "20000",
    "refill": false,
    "cancel": true
  }
]

2. Tambah pesanan

Membuat pesanan baru untuk layanan tertentu. Sediakan ID service, link target, dan quantity. Respons mengembalikan ID order yang baru.

Parameter

• service: ID layanan dari daftar layanan
• link: URL dari postingan/profil/channel
• quantity: jumlah unit yang akan dikirim

Permintaan

key=YOUR_API_KEY
action=add
service=1
link=https://instagram.com/example
quantity=1000

Respons

{
  "order": 23501
}

3. Tambah pesanan: drip-feed

Drip-feed memecah satu pesanan menjadi beberapa pengiriman lebih kecil yang tersebar dari waktu ke waktu, untuk kurva yang lebih organik. Atur runs (berapa kali pengiriman) dan interval (menit antar setiap run). Total yang dikirim sama dengan quantity × runs.

Parameter tambahan

• runs: jumlah run pengiriman
• interval: menit antar setiap run

Permintaan

key=YOUR_API_KEY
action=add
service=1
link=https://instagram.com/example
quantity=1000
runs=10
interval=60

Respons

{
  "order": 23502
}

4. Status pesanan

Mengembalikan kondisi terkini dari satu pesanan: biaya, jumlah awal, status saat ini, kuantitas tersisa, dan mata uang.

Permintaan

key=YOUR_API_KEY
action=status
order=23501

Respons

{
  "charge": "0.90",
  "start_count": "4250",
  "status": "In progress",
  "remains": "200",
  "currency": "USD"
}

Kemungkinan nilai status: Pending, In progress, Processing, Completed, Partial, Canceled.

5. Status banyak pesanan

Cek beberapa pesanan sekaligus dengan mengirimkan daftar ID yang dipisahkan koma pada parameter orders. Respons dikelompokkan berdasarkan ID pesanan.

Permintaan

key=YOUR_API_KEY
action=status
orders=23501,23502,23503

Respons

{
  "23501": {
    "charge": "0.90",
    "start_count": "4250",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "23502": {
    "charge": "9.00",
    "start_count": "1200",
    "status": "In progress",
    "remains": "500",
    "currency": "USD"
  },
  "23503": {
    "error": "Incorrect order ID"
  }
}

6. Refill

Meminta refill untuk pesanan yang layanannya mendukungnya (refill: true pada daftar layanan). Mengembalikan ID refill yang dapat Anda lacak. Kirim satu order atau daftar orders yang dipisahkan koma.

Permintaan (tunggal)

key=YOUR_API_KEY
action=refill
order=23501

Respons

{
  "refill": 4001
}

Permintaan (banyak)

key=YOUR_API_KEY
action=refill
orders=23501,23502

Respons

[
  { "order": 23501, "refill": 4001 },
  { "order": 23502, "refill": { "error": "Refill not available" } }
]

7. Batalkan

Meminta pembatalan satu atau beberapa pesanan yang belum diproses (layanan dengan cancel: true). Kirim daftar orders yang dipisahkan koma. Respons melaporkan hasilnya per pesanan.

Permintaan

key=YOUR_API_KEY
action=cancel
orders=23501,23502

Respons

[
  { "order": 23501, "cancel": 1 },
  { "order": 23502, "cancel": { "error": "Incorrect order ID" } }
]

8. Saldo

Mengembalikan saldo dan mata uang terkini dari akun reseller Anda. Gunakan untuk membatasi pesanan di sisi klien dan menampilkan dana di panel Anda sendiri.

Permintaan

key=YOUR_API_KEY
action=balance

Respons

{
  "balance": "182.45",
  "currency": "USD"
}

Contoh: cURL

Permintaan lengkap untuk membuat pesanan dari baris perintah:

curl -X POST https://api.socialgo.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=1" \
  -d "link=https://instagram.com/example" \
  -d "quantity=1000"

Catatan & praktik terbaik

• Baca sebelum menulis. Panggil services (atau balance) untuk mengonfirmasi tarif, batasan, dan dana, lalu panggil add. Pengaman cari-lalu-bertindak yang sama yang digunakan dasbor dan server MCP agar tidak ada yang dibelanjakan tanpa harga yang dikonfirmasi.
• Simpan cache daftar layanan dan segarkan secara berkala. ID, tarif, dan batasan dapat berubah.
• Selalu validasi kuantitas min/max sebelum mengirim pesanan untuk menghindari permintaan yang ditolak.
• Lakukan polling status pesanan secara batch dengan panggilan banyak-pesanan alih-alih satu permintaan per pesanan.
• Simpan key Anda di sisi server. Jika key pernah terekspos, segera rotasi dari dasbor.