Dokumen API proksi, automasi pesanan dan maklumat sambungan
API pembangun SMMProxy menyediakan imbangan, semakan harga, pesanan proxy dan senarai maklumat sambungan melalui HTTPS REST. Buat kunci di menu API Key dashboard dan hantar dalam header Authorization sebagai Bearer key.
Mulakan
- Buat akaun dan lakukan pengisian pertama. Kunci API boleh dibuat dalam akaun yang telah melakukan sekurang-kurangnya satu pengisian.
- Buat kunci baru di menu kunci API papan pemuka. Kunci hanya dipaparkan sekali semasa penciptaan, jadi simpan dengan segera.
- Masukkan kunci Authorization: Bearer dalam setiap permintaan. Respons dalam JSON dan selalu ada ruang 'ok'.
Alamat Asas: https://smmproxy.io/api/v1
curl -H "Authorization: Bearer smpk_YOUR_KEY" https://smmproxy.io/api/v1/balance
GET/api/v1/balance
Semak Baki
Contoh respons
{ "ok": true, "balance": "48.20", "currency": "USD" }GET/api/v1/products
Semak Produk, Negara, Harga
Contoh respons
{ "ok": true, "periods": ["1w","2w","1m","2m","3m","6m","9m","12m"],
"products": [{ "product": "isp", "unit": "ip", "countries": [{ "country": "us", "monthly": "1.29" }] }] }POST/api/v1/orders
Pesanan Proksi (Bayar dari Baki)
Isi permintaan
{ "product": "isp", "country": "us", "quantity": 5, "period": "1m" }Contoh respons
{ "ok": true, "order": { "id": "OR-7K2M-Q8XD4P", "product": "isp", "country": "us",
"quantity": 5, "period": "1m", "total": "6.45", "expires_at": "2026-11-21T09:00:00.000Z" } }GET/api/v1/orders
Senarai Pesanan (100 Terkini)
Contoh respons
{ "ok": true, "orders": [{ "id": "OR-7K2M-Q8XD4P", "status": "active", "total": "6.45" }] }GET/api/v1/proxies?order=OR-7K2M-Q8XD4P
Senarai Maklumat Sambungan
Contoh respons
{ "ok": true, "proxies": [{ "host": "198.51.100.24", "http_port": 10842, "socks5_port": 20842,
"username": "u7kq2m", "password": "Xc81pLq0Zr", "country": "us", "expires_at": "..." }] }Nilai pesanan
| Nama | Format | Penerangan |
|---|---|---|
| product | string | isp, mobile, ipv4, residential |
| country | string | Kod negara 2 huruf kecil (us, gb, de ...) |
| quantity | integer | Bilangan IP/port, kediaman dalam GB |
| period | string | 1w 2w 1m 2m 3m 6m 9m 12m (excludes residential) |
| protocol | string | http atau socks5, lalai http (kedua-dua port dikeluarkan) |
Ralat
| HTTP | error | Maksud |
|---|---|---|
| 401 | unauthorized | Kunci tidak ada atau tidak sepadan. Wang tidak akan dikurangkan. |
| 400 | invalid_request | Sila semak semula nilai produk, negara, kuantiti, dan tempoh. Wang tidak akan dikurangkan. |
| 402 | insufficient_balance | Baki kurang daripada jumlah pembayaran. Isi semula dan cuba lagi. Wang tidak akan dikurangkan. |
| 503 | network_error | Ralat rangkaian semasa menghantar pesanan. Wang tidak akan dikurangkan dan anda boleh mencuba semula sebentar lagi. |
| 429 | rate_limited | You can send up to 300 times per minute. |
Contoh Python
import requests
API = "https://smmproxy.io/api/v1"
H = {"Authorization": "Bearer smpk_YOUR_KEY"}
order = requests.post(f"{API}/orders", headers=H, json={
"product": "isp", "country": "us", "quantity": 5, "period": "1m"}).json()
if order["ok"]:
proxies = requests.get(f"{API}/proxies", headers=H, params={"order": order["order"]["id"]}).json()
for p in proxies["proxies"]:
print(f'{p["host"]}:{p["http_port"]}:{p["username"]}:{p["password"]}')Contoh Node.js
const API = "https://smmproxy.io/api/v1";
const H = { Authorization: "Bearer smpk_YOUR_KEY", "Content-Type": "application/json" };
const r = await fetch(API + "/orders", { method: "POST", headers: H,
body: JSON.stringify({ product: "mobile", country: "gb", quantity: 1, period: "1m" }) });
const j = await r.json();
console.log(j.ok ? j.order.id : j.error);