ProxySell — Tài liệu API (Client)

1) Tổng quan

API flow: get_proxy_available → check_proxy_available → create_order → create_proxy.

Environments

Prod: https://api.proxysell.net
Dev: https://dev.proxysell.net

Dev tích hợp không tạo đơn. Trả dữ liệu demo/test.

Định dạng

Content-Type: application/json

Response: JSON

HTTP 200 cho request hợp lệ.

2) Xác thực

Bearer: Authorization: Bearer <API_TOKEN>
Token (raw): Authorization: <API_TOKEN>
None: không gửi (khi được phép).

3) Mô hình lỗi

{
  "status": false,
  "msg": "Thông tin mua không đúng",
  "code": "INVALID_ORDER_INFO"
}

GET get_proxy_available

Hiển thị danh sách các loại proxy và các thông tin liên quan.

Biến thể: /get_proxy_available, /v6, /v4_all, /v4, /vip, /residential,

Mỗi loại có validatePeriod khác nhau (ví dụ: v4_all: 30/60/90; v4: 5/10/20/30; residential: 1/3/5/10/20/30; v6/vip: 1→360 theo bước đã cấu hình). Với v4 API còn trả website (danh mục code từ ps_category).

cURL

curl --location 'https://api.proxysell.net/get_proxy_available/v6' --header 'Authorization: Bearer <TOKEN>'

fetch()

const res = await fetch('https://api.proxysell.net/get_proxy_available/v6', {
  headers: { Authorization: 'Bearer <TOKEN>' }
});
const data = await res.json();

POST check_proxy_available

Kiểm tra tồn kho có thể mua theo từng loại proxy và quốc gia.

Tham số

Trường	Kiểu	Bắt buộc	Mô tả
country_id	number	✓	ID quốc gia (lấy từ get_proxy_available).
proxy_type	string	✓	v4 \| v6 \| vip \| residential

Lưu ý: Với v4_all API chỉ trả khi countProxy > 0.

cURL

curl --location 'https://api.proxysell.net/check_proxy_available' --header 'Content-Type: application/json' --header 'Authorization: Bearer <TOKEN>' --data '{"country_id":57,"proxy_type":"v6"}'

fetch()

const res = await fetch('https://api.proxysell.net/check_proxy_available', {
  method: 'POST',
  headers: {'Content-Type':'application/json', Authorization: 'Bearer <TOKEN>'},
  body: JSON.stringify({ country_id: 57, proxy_type: 'v6' })
});
const data = await res.json();

POST create_order

Tạo đơn.

Tham số

Trường	Kiểu	Bắt buộc	Mô tả
proxy	string	✓	v6 \| v4 \| vip \| residential
proxy_type	string	đk	Bắt buộc với một số loại (ví dụ rotating). Giá trị: free \| static \| rotating
rotating_interval	number	đk	Bắt buộc khi proxy_type là xoay (1→59 phút).
website	string	✓*	Chỉ với v4: facebook \| vkontakte \| v4_all...
mode	string	✓	buy \| cal
quantity	number	✓	Số lượng (tối thiểu tuỳ gói; ví dụ rotating có thể ≥5, static ≥10 ở một số product).
period	number	✓	Ngày; phải thuộc `validatePeriod` của từng product.
country_id	number	✓	ID quốc gia.
protocol	number	✓	0=HTTP, 1=SOCKS5
authent	number	✓	0=No Authent, 1=Authent
network	string	-	Dành cho residential: Viettel \| FPT \| VNPT (mặc định: Viettel)

cURL (v6/residential - static)

curl --location 'https://api.proxysell.net/create_order' --header 'Content-Type: application/json' --header 'Authorization: Bearer <TOKEN>' --data '{
  "proxy": "v6",
  "proxy_type": "static",
  "mode": "buy",
  "quantity": 10,
  "period": 30,
  "country_id": 57,
  "protocol": 0,
  "authent": 1,
  "network": "Viettel"
}'

cURL (v4)

curl --location 'https://api.proxysell.net/create_order' --header 'Content-Type: application/json' --header 'Authorization: Bearer <TOKEN>' --data '{
  "proxy": "v4",
  "website": "facebook", // v4_all hoặc code từ API get_proxy_available (facebook|vkontakte)
  "mode": "buy",
  "quantity": 5,
  "period": 10,
  "country_id": 159,
  "protocol": 1,
  "authent": 1
}'

cURL (residential)

curl --location 'https://api.proxysell.net/create_order' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <TOKEN>' \
--data '{
  "proxy": "residential",
  "proxy_type": "rotating",
  "rotating_interval": 10,
  "mode": "buy",
  "quantity": 5,
  "period": 7,
  "country_id": 57,
  "protocol": 0,
  "authent": 1,
  "network": "Viettel"
}'

POST create_proxy

Tạo proxy theo đơn vừa mua.

Tham số

Trường	Kiểu	Bắt buộc	Mô tả
order_id	number	✓	ID đơn hàng từ create_order.

cURL

curl --location 'https://api.proxysell.net/create_proxy' --header 'Content-Type: application/json' --header 'Authorization: Bearer <TOKEN>' --data '{
  "order_id": 5
}'

fetch()

const res = await fetch('https://api.proxysell.net/create_proxy', {
  method: 'POST',
  headers: {'Content-Type':'application/json', Authorization: 'Bearer <TOKEN>'},
  body: JSON.stringify({ order_id: 10159 })
});
const data = await res.json();

Lưu ý: Chỉ chủ đơn (hoặc admin) mới tạo được proxy. Ở môi trường prod, đơn đã xử lý trước đó có thể bị chặn tạo lại.

POST get_proxy_pending

Lấy danh sách proxy đang chờ xử lý/đang cấp (theo order_id).

Trường	Kiểu	Bắt buộc	Mô tả
order_id	number	✓	ID đơn hàng.

cURL

curl --location 'https://api.proxysell.net/get_proxy_pending' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <TOKEN>' \
--data '{"order_id":10159}'

POST proxy/(list|start|update|rotate|rotateInterval|stop|delete|status)

API thao tác với từng proxy / gói proxy thuộc một đơn hàng (order).
Lưu ý: Gửi Authorization theo cấu hình của bạn. Trả về JSON.

Endpoint	Mục đích
`/proxy/list`	Liệt kê proxy của `order_id` (tuỳ gói: ip/ports/creds, protocol).
`/proxy/start`	Khởi chạy toàn đơn hoặc một `port`.
`/proxy/update`	Đổi username/password cho 1 port hoặc toàn đơn.
`/proxy/rotate`	Rotate ngay (không dành cho đơn static).
`/proxy/rotateInterval`	Đặt chu kỳ quay định kỳ (phút) cho đơn xoay.
`/proxy/stop`	Dừng toàn bộ hoặc 1 `port`.
`/proxy/delete`	Gỡ/xoá proxy (toàn đơn hoặc 1 `port`, tuỳ backend hỗ trợ).
`/proxy/status`	Trạng thái nhanh theo `order_id` (và `port` nếu có).

Đã bỏ /proxy/cancel khỏi tài liệu (không có trong backend hiện tại).

/proxy/list — Tham số

Trường	Kiểu	Bắt buộc	Mô tả
order_id	number	✓	ID đơn hàng cần liệt kê proxy.

cURL (list)

curl --location 'https://api.proxysell.net/proxy/list' --header 'Content-Type: application/json' --header 'Authorization: Bearer <TOKEN>' --data '{"order_id":10159}'

/proxy/start — Tham số

Trường	Kiểu	Bắt buộc	Mô tả
order_id	number	✓	Đơn cần khởi chạy proxy.
port	number	-	Nếu truyền, chỉ khởi chạy một port cụ thể; nếu bỏ trống áp dụng cho toàn đơn.

cURL (start toàn đơn)

curl --location 'https://api.proxysell.net/proxy/start' --header 'Content-Type: application/json' --header 'Authorization: Bearer <TOKEN>' --data '{"order_id":10159}'

cURL (start một port)

curl --location 'https://api.proxysell.net/proxy/start' --header 'Content-Type: application/json' --header 'Authorization: Bearer <TOKEN>' --data '{"order_id":10159,"port":5111}'

/proxy/update — Tham số

Trường	Kiểu	Bắt buộc	Mô tả
order_id	number	✓	Đơn chứa port cần cập nhật.
port	number	-	Port cụ thể cần đổi thông tin. Nếu bỏ trống và gửi username/password sẽ áp dụng cho toàn đơn (nếu backend hỗ trợ).
username	string	-	Tên đăng nhập mới.
password	string	-	Mật khẩu mới.

cURL (update một port)

curl --location 'https://api.proxysell.net/proxy/update' --header 'Content-Type: application/json' --header 'Authorization: Bearer <TOKEN>' --data '{"order_id":10159,"port":5111,"username":"u1","password":"p1"}'

cURL (update all port)

curl --location 'https://api.proxysell.net/proxy/update' --header 'Content-Type: application/json' --header 'Authorization: Bearer <TOKEN>' --data '{"order_id":10159,"username":"u1","password":"p1"}'

/proxy/rotate — Tham số

Trường	Kiểu	Bắt buộc	Mô tả
order_id	number	✓	Đơn cần rotate IP/định danh.
port	number	-	Nếu truyền, chỉ rotate cho một port; nếu bỏ trống áp dụng cho toàn đơn.
rotating_interval	number	-	Nếu backend hỗ trợ: giá trị 1→59 (phút).

cURL (rotate toàn đơn)

curl --location 'https://api.proxysell.net/proxy/rotate' --header 'Content-Type: application/json' --header 'Authorization: Bearer <TOKEN>' --data '{"order_id":10159}'

cURL (rotate + interval + 1 port)

curl --location 'https://api.proxysell.net/proxy/rotate' --header 'Content-Type: application/json' --header 'Authorization: Bearer <TOKEN>' --data '{"order_id":10159,"port":5111,"rotating_interval":15}'

/proxy/rotateInterval — Tham số

Trường	Kiểu	Bắt buộc	Mô tả
order_id	number	✓	Đơn cần đặt chu kỳ quay.
rotating_interval	number	✓	Phút (1→59). Chỉ áp dụng cho đơn rotating.

cURL (rotateInterval)

curl --location 'https://api.proxysell.net/proxy/rotateInterval' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <TOKEN>' \
--data '{"order_id":10159,"rotating_interval":15}'

/proxy/stop — Tham số

Trường	Kiểu	Bắt buộc	Mô tả
order_id	number	✓	Đơn cần dừng proxy.
port	number	-	Chỉ dừng một port nếu truyền; nếu bỏ trống dừng toàn bộ.

cURL (stop toàn đơn)

curl --location 'https://api.proxysell.net/proxy/stop' --header 'Content-Type: application/json' --header 'Authorization: Bearer <TOKEN>' --data '{"order_id":10159}'

/proxy/delete — Tham số

Trường	Kiểu	Bắt buộc	Mô tả
order_id	number	✓	Đơn cần gỡ proxy.
port	number	-	Nếu truyền, chỉ gỡ 1 port; nếu trống áp dụng cho toàn đơn (tuỳ backend hỗ trợ).

cURL (delete 1 port)

curl --location 'https://api.proxysell.net/proxy/delete' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <TOKEN>' \
--data '{"order_id":10159,"port":5111}'

/proxy/status — Tham số

Trường	Kiểu	Bắt buộc	Mô tả
order_id	number	✓	Lấy trạng thái theo đơn.
port	number	-	Nếu truyền, trạng thái cho một port.

cURL (status)

curl --location 'https://api.proxysell.net/proxy/status' --header 'Content-Type: application/json' --header 'Authorization: Bearer <TOKEN>' --data '{"order_id":10159}'