Skip to content
Tài liệu tham khảo API
/
/
/
Thêm máy chủ proxy

Thêm máy chủ proxy

Request

Tạo một cấu hình proxy trong nhóm.

  • Điều kiện tiên quyết: proxyPort là bắt buộc và phải nằm trong 1–65535, còn proxyProvider phải là một nhà cung cấp được nhận diện.
  • Tác động: chèn một bản ghi proxy và trả về ID của nó, sẵn sàng để gán cho các profile. Không có gì được gửi tới nhà cung cấp proxy.
  • Hoàn tất: đồng bộ.
  • Thử lại: không có bước kiểm tra trùng tên hay trùng cấu hình. Gửi cùng một request body hai lần sẽ tạo ra hai proxy với hai ID. Sau khi hết thời gian chờ, hãy tìm trong /proxyInfo/page trước khi gửi lại.

Các mã lỗi nghiệp vụ đã ghi nhận: 14023. Xem Error Codes để biết ý nghĩa từng mã. Mọi thao tác cũng có thể trả về các mã dùng chung.

Bodyapplication/jsonrequired
citystring

Thành phố

Example:""
countrystring

Mã quốc gia (ISO 3166-1 alpha-2). Chỉ bắt buộc nếu proxyProvider=17.

Example:"AD"
encryptionTypeinteger, (int32)

Loại mã hóa, các giá trị hợp lệ là các số nguyên từ 1 đến 14.

Example:14
ipChangeActioninteger, (int32)

Hành động khi thay đổi địa chỉ IP: 0 = Chặn, 1 = Cảnh báo

Example:1
ipMonitorboolean

Bật tính năng giám sát thay đổi địa chỉ IP

Example:false
passwordstring

Mật khẩu để xác thực proxy

Example:""
proxyIpstringrequired

Địa chỉ IP proxy

Example:"8.10.22.46"
proxyNamestring

Tên proxy (hỗ trợ các ký tự đại diện như {{random}})

Example:"sock5_{{random}}"
proxyPortinteger, (int32)required

Số cổng proxy

Example:65534
proxyProviderinteger, (int32)required

Loại nhà cung cấp proxy: 0=HTTP, 1=HTTPS, 2=SOCKS5, 3=SSH, 4=Oxylabs, 5=Proxys.io, 6=GeoSurf, 7=Luminati, 8=Lumauto, 9=Oxylabsauto, 10=Trojan, 11=Shadowsocks, 12=vmess, 13=ABCPROXY, 14=LunaProxy, 15=IPHTML, 16=PiaProxy, 17=922S5.

Quy tắc đặc biệt:

  • Nếu proxyProvider là 7 hoặc 8, proxyType là bắt buộc.

  • Nếu proxyProvider là 17, quốc gia là bắt buộc; tiểu bang và thành phố là tùy chọn.

Example:2
proxyTypeinteger, (int32)

Loại giao thức proxy: 0=HTTP, 1=HTTPS, 2=SOCKS5, 3=SSH.

Chỉ cần thiết khi proxyProvider là 7 hoặc 8.

Example:1
refreshUrlstring

URL để làm mới địa chỉ IP proxy động (nếu được hỗ trợ)

Example:""
statestring

Tiểu bang/Tỉnh

Example:""
usernamestring

Tên người dùng để xác thực proxy

Example:""
POST
/api/proxyInfo/add
curl -i -X POST \
  http://127.0.0.1:40000/api/proxyInfo/add \
  -H 'Content-Type: application/json' \
  -d '{
    "proxyIp": "8.10.22.46",
    "proxyPort": 65534,
    "proxyProvider": 2,
    "proxyType": 1,
    "country": "AD",
    "state": "",
    "city": "",
    "encryptionType": 14,
    "ipChangeAction": 1,
    "ipMonitor": false,
    "proxyName": "sock5_{{random}}",
    "refreshUrl": "",
    "username": "",
    "password": ""
  }'

Responses

Thành công. data là một giá trị số nguyên duy nhất.

Headers
any
Bodyapplication/json
codeintegerrequired

Mã trả về 0: Bình thường. Các mã khác là ngoại lệ.

msgstring or nullrequired

Thông báo lỗi

dataintegerrequired

ID ủy quyền

requestIdstringrequired

ID yêu cầu vận hành

Response
{
  "code": 0,
  "msg": "",
  "data": 0,
  "requestId": "abcd1234"
}