Tài liệu API Proxy và tích hợp

Máy chủ và cổng

Mỗi mạng có một máy chủ. HTTP và HTTPS dùng chung cổng đầu tiên, SOCKS5 dùng cổng thứ hai. Tên người dùng và mật khẩu lấy từ gói trong bảng điều khiển của bạn và giống nhau cho cả hai giao thức.

Gói ISP tĩnh liệt kê mỗi địa chỉ với cổng riêng thay vì máy chủ chung: kết nối đến ip:port với tên người dùng và mật khẩu của gói.

Khóa tên người dùng

Các khóa được thêm vào tên người dùng của bạn bằng dấu gạch ngang và có thể kết hợp theo bất kỳ thứ tự nào. Không có khóa, gói luân phiên sẽ trả về địa chỉ ngẫu nhiên tại bất kỳ quốc gia nào.

USER-country-de-city-berlin-session-k7p2x9-ttl-60:PASS@res.proxyhive.cc:7000

Mẫu mã

Thay USER và PASS bằng thông tin đăng nhập của gói bạn. Các mẫu gửi một yêu cầu qua cổng và in câu trả lời.

curl -x res.proxyhive.cc:7000 -U "USER-country-us:PASS" \
  https://example.com

API REST

Địa chỉ cơ sở https://proxyhive.cc/api/v1. Câu trả lời là JSON và luôn có ok. Các điểm cuối công khai không cần khóa; điểm cuối tài khoản cần tiêu đề Authorization: Bearer với khóa API từ trang tài khoản của bạn.

curl -X POST https://proxyhive.cc/api/v1/orders \
  -H "Authorization: Bearer phk_..." \
  -H "Content-Type: application/json" \
  -d '{"plan": "res-100", "country": "any"}'

{
  "ok": true,
  "order": {
    "id": "HO-7K2M9QXR4T",
    "product": "resi",
    "plan": "res-100",
    "quantity": 100,
    "unit": "GB",
    "status": "active",
    "gateway": { "host": "res.proxyhive.cc", "http_port": 7000, "socks5_port": 7001, "username": "...", "password": "..." }
  }
}

Lỗi và giới hạn

Các lệnh thất bại trả lời ok: false với mã lỗi và thông báo: unauthorized (401), bad_plan hoặc bad_country (400), funds (402, với số tiền còn thiếu), network (503, không tính phí) và rate_limited (429). Mỗi khóa API có thể gửi 300 yêu cầu mỗi phút.