Dokumen API proxy: Dapatkan senarai proxy melalui API REST

Apa yang boleh dilakukan dengan API?

Gunakan API apabila program yang menggunakan proksi mengambil senarai terkini secara langsung. Anda boleh membuat crawler mengambil senarai setiap kali ia bermula, atau pelayan menukar senarai secara automatik apabila pelan baharu dibeli atau tamat tempoh. Senarai yang dimuat turun dari dashboard dan diterima melalui API adalah data yang sama.

API adalah baca sahaja. Ia menyokong semakan baki, senarai pelan, dan carian senarai proksi, manakala pembayaran dan pembelian dilakukan dalam dashboard. Semua respons adalah UTF-8 dan tarikh dalam format ISO 8601 UTC.

Bagaimana cara membuat dan menghantar kunci API?

Buat kunci API di skrin kunci API papan pemuka. Kunci bermula dengan spx_ dan mempunyai 44 aksara, dan hanya akan dipaparkan sekali semasa penciptaan. Pelayan hanya menyimpan cap jari (hash) kunci, jadi jika anda kehilangannya, anda boleh membuat kunci baharu, dan kunci lama akan berhenti berfungsi serta-merta.

Tambahkan kunci dengan kaedah Bearer dalam header Authorization setiap permintaan. Kaedah kunci dalam kueri alamat tidak diterima. 401 unauthorized akan dikembalikan jika tiada atau salah kunci.

curl -H "Authorization: Bearer spx_your_api_key" https://socks5proxy.io/api/v1/account

Semak maklumat baki dan akaun: GET /account

Mengembalikan kod akaun, baki, bilangan pelan aktif dan bilangan proxy. Baki adalah dalam format aksara dengan dua tempat perpuluhan (USD).

curl -H "Authorization: Bearer spx_your_api_key" https://socks5proxy.io/api/v1/account

{
  "code": "S5-7KQ2-M8PX-4HDA",
  "balance": "125.40",
  "currency": "USD",
  "active_plans": 2,
  "proxies": 125,
  "created_at": "2026-10-22T08:15:02.114Z"
}

Semak senarai pelan: GET /plans

Kembalikan pelan yang dibeli dari yang terkini. Status adalah antara active (sedang digunakan), expired (tempoh tamat), canceled (dibatalkan). id adalah kod pelan (bermula dengan P-) dan boleh digunakan sebagai nilai plan dalam /proxies.

{
  "plans": [
    {
      "id": "P-8WQ4C-NM2KT",
      "product": "dc-private",
      "product_name": "Private Datacenter Proxy",
      "ips": 100,
      "months": 1,
      "country": "us",
      "status": "active",
      "amount": "49.40",
      "created_at": "2026-10-22T08:20:11.002Z",
      "expires_at": "2026-11-22T08:20:11.002Z"
    }
  ]
}

Semakan senarai proxy: GET /proxies

Mengembalikan proksi daripada pelan yang sedang digunakan dalam format JSON. Setiap proksi mengandungi alamat, port HTTP, port SOCKS5, nama pengguna, kata laluan, negara, bandar, kod pelan, dan masa tamat.

Anda boleh menapis dengan country (kod negara dua huruf, contoh: us) dan plan (kod pelan). Nilai protocol dipaparkan dalam respons, dan JSON mengandungi kedua-dua port.

curl -H "Authorization: Bearer spx_your_api_key" \
  "https://socks5proxy.io/api/v1/proxies?country=us&protocol=socks5"

{
  "count": 1,
  "protocol": "socks5",
  "proxies": [
    {
      "host": "198.51.100.23",
      "http_port": 8231,
      "socks5_port": 1080,
      "username": "spx_k2m8qa",
      "password": "q7rbx2wd9n",
      "country": "us",
      "city": "New York",
      "plan": "P-8WQ4C-NM2KT",
      "product": "dc-private",
      "product_name": "Private Datacenter Proxy",
      "expires_at": "2026-11-22T08:20:11.002Z"
    }
  ]
}

Muat turun senarai: GET /proxies/download

Kembalikan satu proxy setiap baris dalam format teks untuk bacaan langsung oleh program. Untuk protocol=socks5, gunakan port SOCKS5; untuk http, gunakan port HTTP. format=url menambah awalan (socks5:// atau http://) mengikut protocol.

Pada pelayan dengan pengesahan IP yang dibenarkan diaktifkan, anda boleh menyambung terus menggunakan format ip:port tanpa nama pengguna. CSV mengandungi nama lajur pada baris pertama dan kedua-dua port.

curl -H "Authorization: Bearer spx_your_api_key" \
  "https://socks5proxy.io/api/v1/proxies/download?format=url&protocol=socks5" -o proxies.txt

Contoh kode: Python, Node.js, PHP

Contoh di bawah menerima senarai dan menghantar permintaan melalui proksi pertama. Python memerlukan pakej requests[socks] untuk SOCKS5, dan socks5h juga menyelesaikan nama domain melalui proksi.

import requests

API = "https://socks5proxy.io/api/v1"
H = {"Authorization": "Bearer spx_your_api_key"}

proxies = requests.get(f"{API}/proxies", headers=H, params={"country": "us"}).json()["proxies"]
p = proxies[0]
url = f"socks5h://{p['username']}:{p['password']}@{p['host']}:{p['socks5_port']}"
r = requests.get("https://api.ipify.org?format=json", proxies={"http": url, "https": url}, timeout=30)
print(r.json())

import { ProxyAgent, fetch } from "undici";

const API = "https://socks5proxy.io/api/v1";
const H = { Authorization: "Bearer spx_your_api_key" };

const { proxies } = await (await fetch(`${API}/proxies?country=us`, { headers: H })).json();
const p = proxies[0];
const agent = new ProxyAgent(`http://${p.username}:${p.password}@${p.host}:${p.http_port}`);
const r = await fetch("https://api.ipify.org?format=json", { dispatcher: agent });
console.log(await r.json());

<?php
$ch = curl_init("https://socks5proxy.io/api/v1/proxies/download?format=ip:port:user:pass&protocol=http");
curl_setopt_array($ch, [
  CURLOPT_HTTPHEADER => ["Authorization: Bearer spx_your_api_key"],
  CURLOPT_RETURNTRANSFER => true,
]);
$lines = explode("\n", trim(curl_exec($ch)));
[$host, $port, $user, $pass] = explode(":", $lines[0]);
echo "$host:$port\n";

Kod ralat dan had panggilan

Ralat dikembalikan dalam format { "error": { "code", "message" } } bersama kod status HTTP. Anda boleh memanggil sehingga 300 kali seminit setiap kunci, dan jika melebihi, anda akan menerima respons 429 selama 1 minit. Senarai hanya berubah semasa pembelian atau tamat tempoh, jadi disarankan untuk mengambilnya sekali setiap beberapa minit dan menggunakannya semula dalam program.

Panggilan API tidak dikenakan bayaran. Baki hanya dikurangkan apabila anda membeli pelan dalam dashboard.