ProxyLite OpenAPI

Bạn có thể xem mã xác thực app_key trên trang chủ trung tâm cá nhân của mình sau khi đăng nhập.

Vui lòng giữ mã này an toàn, vì nó được quản trị viên tài khoản của bạn lưu giữ.

Base URLs:

https://api.proxylite.com

Phương thức xác thực

Xác thực bằng khóa ứng dụng

Các tham số POST:

app_key: {your_app_key}

Hoặc dưới dạng tham số truy vấn:

?app_key={your_app_key}

Định dạng phản hồi

Tất cả các API đều trả về định dạng JSON thống nhất:

{
	"code": 200,
	"message": "操作成功",
	"data": {}
}

code: Mã trạng thái; 200 biểu thị thành công, các giá trị khác biểu thị thất bại.
message: Thông báo phản hồi (bằng tiếng Trung).
data: Dữ liệu phản hồi.

Authentication

Giao diện này hỗ trợ hai phương thức xác thực sau:

1. Bearer Token（JWT）

Mã token được truyền qua tiêu đề HTTP.

Ví dụ về tiêu đề:

Authorization: Bearer <your_jwt_token>

Xác thực khóa API

API này sử dụng Khóa API để xác thực.

Khách hàng phải bao gồm tham số app_key trong yêu cầu của họ; nếu không, yêu cầu sẽ bị từ chối.

Ví dụ:

GET /api/example?app_key=your_app_key

POST /api/example?app_key=your_app_key
Content-Type: application/json

Quản lý tài khoản ủy quyền

Lấy danh sách tài khoản ủy quyền

GET /end-point/whitelist-account/list

Quay lại ví dụ

Phản hồi thành công (200)

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			{
				"id": 0,
				"username": "string",
				"password": "string",
				"created_at": "string",
				"remark": "string",
				"product_type": 9,
				"usage_flow": 0,
				"limit_flow": 102400,
				"status": 0
			}
		]
	}
}

Trả về kết quả

mã trạng thái	Ý nghĩa của mã trạng thái	minh họa	Mô hình dữ liệu
200	OK	Yêu cầu thành công	Inline

Cấu trúc dữ liệu trả về

Mã trạng thái 200

Tên	Kiểu	Bắt buộc	Ràng buộc	Mô tả
» code	responseCode	false	none	Mã trạng thái, 200: thành công, 3: app_key không hợp lệ
» msg	string	false	none	Thông báo trạng thái
» data	object	false	none	—
»» list	[object]	false	none	Danh sách dữ liệu
»»» id	integer	false	none	ID tài khoản
»»» username	string	false	none	Tên tài khoản proxy
»»» password	string	false	none	Mật khẩu tài khoản proxy
»»» created_at	string	false	none	Thời gian tạo
»»» remark	string	false	none	Ghi chú
»»» product_type	productTypes	false	none	Loại gói: 9 Proxy nhà ở động theo lưu lượng, 11 IP nhà ở động, 14 IP trung tâm dữ liệu tĩnh, 25 IP nhà ở tĩnh
»»» usage_flow	integer	false	none	Lưu lượng đã sử dụng, đơn vị: KB
»»» limit_flow	integer	false	none	Giới hạn lưu lượng tùy chỉnh, đơn vị: GB, tối đa 102400, 0: không giới hạn
»»» status	integer	false	none	Trạng thái kích hoạt: 1 bật, 0 tắt

Giá trị liệt kê

tài sản	giá trị
product_type	9
product_type	11
product_type	14
product_type	25

POST Thêm tài khoản đại lý

POST /end-point/whitelist-account/add

Body Tham số yêu cầu

{
	"app_key": "stringstringstringstringstringst",
	"accounts": "user01:pass,user02:pass,user03:pass",
	"remark": "",
	"product_type": 9
}

Tham số yêu cầu

Tên	Vị trí	Kiểu	Bắt buộc	Mô tả
body	body	object	Không	—
» app_key	body	string	Không	Khóa xác thực
» accounts	body	string	Không	Mật khẩu tài khoản, vui lòng nhập theo định dạng `username:password`. Tên tài khoản và mật khẩu chỉ hỗ trợ chữ và số, không cho phép ký tự đặc biệt hoặc khoảng trắng. Tên tài khoản và mật khẩu được phân tách bằng dấu hai chấm (😃. Hỗ trợ thêm hàng loạt, các tài khoản proxy được phân tách bằng dấu phẩy tiếng Anh (,)
» remark	body	string	Không	Mô tả tài khoản proxy
» product_type	body	productTypes	Không	Loại gói: 9 Proxy nhà ở động theo lưu lượng, 11 IP nhà ở động, 14 IP trung tâm dữ liệu tĩnh, 25 IP nhà ở tĩnh

Giá trị liệt kê

Thuộc tính	Giá trị
» product_type	9
» product_type	11
» product_type	14
» product_type	25

Ví dụ phản hồi

200 Response

{
	"code": 200,
	"msg": "string",
	"data": null
}

Kết quả phản hồi

Mã trạng thái	Ý nghĩa mã trạng thái	Mô tả	Mô hình dữ liệu
200	OK	Yêu cầu thành công	Inline

Cấu trúc dữ liệu phản hồi

Mã trạng thái 200

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
» code	integer	false	none	Mã trạng thái, 200 thành công, 3 app_key không hợp lệ, 156 tài khoản chưa xác thực danh tính
» msg	string	false	none	Thông báo trạng thái
» data	null	false	none	none

POST Xóa tài khoản proxy

POST /end-point/whitelist-account/delete

Lưu ý rằng sau khi xóa không thể khôi phục, lưu lượng đã sử dụng không thể truy vấn. Việc xóa có thời gian chờ khoảng 5 phút, trong thời gian này vẫn có thể phát sinh phí.

Body Tham số yêu cầu

{
	"app_key": "stringstringstringstringstringst",
	"accounts": "user01,user02"
}

Tham số yêu cầu

Tên	Vị trí	Loại	Bắt buộc	Mô tả
body	body	object	Không	none
» app_key	body	string	Không	Khóa ủy quyền
» accounts	body	string	Không	Tài khoản proxy, chỉ hỗ trợ số và chữ cái. Hỗ trợ thao tác hàng loạt, phân tách tài khoản proxy bằng dấu phẩy tiếng Anh (,)

Ví dụ phản hồi

200 Response

{
	"code": 200,
	"msg": "string",
	"data": null
}

Kết quả phản hồi

Mã trạng thái	Ý nghĩa mã trạng thái	Mô tả	Mô hình dữ liệu
200	OK	Yêu cầu thành công	Inline

Cấu trúc dữ liệu phản hồi

Mã trạng thái 200

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
» code	integer	false	none	Mã trạng thái, 200 thành công, 3 app_key không hợp lệ, 156 tài khoản chưa xác thực danh tính
» msg	string	false	none	Thông báo trạng thái
» data	null	false	none	none

POST Vô hiệu hóa tài khoản proxy

POST /end-point/whitelist-account/disable

Việc vô hiệu hóa có thời gian chờ khoảng 5 phút, trong thời gian này vẫn có thể phát sinh phí.

Body Tham số yêu cầu

{
	"app_key": "stringstringstringstringstringst",
	"accounts": "user01,user02"
}

Tham số yêu cầu

Tên	Vị trí	Loại	Bắt buộc	Mô tả
body	body	object	Không	none
» app_key	body	string	Không	Khóa ủy quyền
» accounts	body	string	Không	Tài khoản proxy, chỉ hỗ trợ số và chữ cái. Hỗ trợ thao tác hàng loạt, phân tách tài khoản proxy bằng dấu phẩy tiếng Anh (,)

Ví dụ phản hồi

200 Response

{
	"code": 200,
	"msg": "string",
	"data": null
}

Kết quả phản hồi

Mã trạng thái	Ý nghĩa mã trạng thái	Mô tả	Mô hình dữ liệu
200	OK	Yêu cầu thành công	Inline

Cấu trúc dữ liệu phản hồi

Mã trạng thái 200

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
» code	integer	false	none	Mã trạng thái, 200 thành công, 3 app_key không hợp lệ, 156 tài khoản chưa xác thực danh tính
» msg	string	false	none	Thông báo trạng thái
» data	null	false	none	none

POST Kích hoạt tài khoản proxy

POST /end-point/whitelist-account/enable

Body Tham số yêu cầu

{
	"app_key": "stringstringstringstringstringst",
	"accounts": "user01,user02"
}

Tham số yêu cầu

Tên	Vị trí	Loại	Bắt buộc	Mô tả
body	body	object	Không	none
» app_key	body	string	Không	Khóa ủy quyền
» accounts	body	string	Không	Tài khoản proxy, chỉ hỗ trợ số và chữ cái. Hỗ trợ thao tác hàng loạt, phân tách tài khoản proxy bằng dấu phẩy tiếng Anh (,)

Ví dụ phản hồi

200 Response

{
	"code": 200,
	"msg": "string",
	"data": null
}

Kết quả phản hồi

Mã trạng thái	Ý nghĩa mã trạng thái	Mô tả	Mô hình dữ liệu
200	OK	Yêu cầu thành công	Inline

Cấu trúc dữ liệu phản hồi

Mã trạng thái 200

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
» code	integer	false	none	Mã trạng thái, 200 thành công, 3 app_key không hợp lệ, 156 tài khoản chưa xác thực danh tính
» msg	string	false	none	Thông báo trạng thái
» data	null	false	none	none

POST Thay đổi mật khẩu tài khoản proxy

POST /end-point/whitelist-account/change-password

Lưu ý rằng sau khi thay đổi có thời gian chờ 5 phút, trong thời gian này mật khẩu cũ vẫn có thể được sử dụng bình thường.

Body Tham số yêu cầu

{
	"app_key": "stringstringstringstringstringst",
	"account": "user",
	"password": "pass"
}

Tham số yêu cầu

Tên	Vị trí	Loại	Bắt buộc	Mô tả
body	body	object	Không	none
» app_key	body	string	Không	Khóa ủy quyền
» account	body	string	Không	Tài khoản proxy, chỉ hỗ trợ số và chữ cái.
» password	body	string	Không	Mật khẩu mới của tài khoản proxy, chỉ hỗ trợ số và chữ cái.

Ví dụ phản hồi

200 Response

{
	"code": 200,
	"msg": "string",
	"data": null
}

Kết quả phản hồi

Mã trạng thái	Ý nghĩa mã trạng thái	Mô tả	Mô hình dữ liệu
200	OK	Yêu cầu thành công	Inline

Cấu trúc dữ liệu phản hồi

Mã trạng thái 200

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
» code	integer	false	none	Mã trạng thái, 200 thành công, 3 app_key không hợp lệ, 156 tài khoản chưa xác thực danh tính
» msg	string	false	none	Thông báo trạng thái
» data	null	false	none	none

POST Thay đổi ghi chú tài khoản proxy

POST /end-point/whitelist-account/change-remark

Body Tham số yêu cầu

{
	"app_key": "stringstringstringstringstringst",
	"account": "user",
	"remark": ""
}

Tham số yêu cầu

Tên	Vị trí	Loại	Bắt buộc	Mô tả
body	body	object	Không	none
» app_key	body	string	Không	Khóa ủy quyền
» account	body	string	Không	Tài khoản proxy, chỉ hỗ trợ số và chữ cái.
» remark	body	string	Không	Ghi chú mới của tài khoản proxy, trong vòng 32 ký tự tiếng Trung hoặc 64 ký tự tiếng Anh.

Ví dụ phản hồi

200 Response

{
	"code": 200,
	"msg": "string",
	"data": null
}

Kết quả phản hồi

Mã trạng thái	Ý nghĩa mã trạng thái	Mô tả	Mô hình dữ liệu
200	OK	Yêu cầu thành công	Inline

Cấu trúc dữ liệu phản hồi

Mã trạng thái 200

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
» code	integer	false	none	Mã trạng thái, 200 thành công, 3 app_key không hợp lệ, 156 tài khoản chưa xác thực danh tính
» msg	string	false	none	Thông báo trạng thái
» data	null	false	none	none

POST Thay đổi giới hạn lưu lượng tài khoản proxy

POST /end-point/whitelist-account/change-limit

Lưu ý rằng thống kê lưu lượng có thể có độ trễ trong vòng 5 phút, tức là lưu lượng tiêu thụ thực tế có thể vượt quá giới hạn này.

Body Tham số yêu cầu

{
	"app_key": "stringstringstringstringstringst",
	"account": "user",
	"limit": 0
}

Tham số yêu cầu

Tên	Vị trí	Loại	Bắt buộc	Mô tả
body	body	object	Không	none
» app_key	body	string	Không	Khóa ủy quyền
» account	body	string	Không	Tài khoản proxy, chỉ hỗ trợ số và chữ cái.
» limit	body	integer	Không	Giới hạn lưu lượng, đơn vị: GB, 0 là không giới hạn

Ví dụ phản hồi

200 Response

{
	"code": 200,
	"msg": "string",
	"data": null
}

Kết quả phản hồi

Mã trạng thái	Ý nghĩa mã trạng thái	Mô tả	Mô hình dữ liệu
200	OK	Yêu cầu thành công	Inline

Cấu trúc dữ liệu phản hồi

Mã trạng thái 200

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
» code	integer	false	none	Mã trạng thái, 200 thành công, 3 app_key không hợp lệ, 156 tài khoản chưa xác thực danh tính
» msg	string	false	none	Thông báo trạng thái
» data	null	false	none	none

Truy vấn nhật ký lưu lượng

GET Tổng hợp lưu lượng sử dụng theo ngày

GET /end-point/user-usage-flow/total

Tham số yêu cầu

Tên	Vị trí	Loại	Bắt buộc	Mô tả
app_key	query	string(password)	Có	Khóa xác thực
start_time	query	string(Y-m-d H:i:s)	Không	Thời gian bắt đầu, có thể chính xác đến giây. Lưu ý rằng ghi nhật ký có độ trễ trong vòng 5 phút. Mặc định trong vòng 7 ngày.
end_time	query	string(Y-m-d H:i:s)	Không	Thời gian kết thúc, có thể chính xác đến giây. Lưu ý rằng ghi nhật ký có độ trễ trong vòng 5 phút. Mặc định là thời gian hiện tại.
username	query	string	Không	Tên tài khoản phụ, mặc định truy vấn tất cả tài khoản, có thể chỉ định tài khoản phụ. Lưu ý nếu bạn đã thêm tài khoản phụ cùng tên, truy vấn này sẽ trả về tất cả bản ghi sử dụng của tài khoản proxy cùng tên.
product_type	query	number	Không	Loại gói dịch vụ

Ví dụ phản hồi

200 Response

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			{
				"day": "2022-08-01",
				"flow": 0
			}
		]
	}
}

Kết quả phản hồi

Mã trạng thái	Ý nghĩa mã trạng thái	Mô tả	Mô hình dữ liệu
200	OK	Yêu cầu thành công	Inline

Cấu trúc dữ liệu phản hồi

Mã trạng thái 200

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
» code	integer	false	none	Mã trạng thái, 200 thành công, 3 app_key không hợp lệ, 156 tài khoản chưa xác thực danh tính
» msg	string	false	none	Thông báo trạng thái
» data	object	false	none	none
»» list	[object]	false	none	none
»»» day	string	false	none	Ngày
»»» flow	integer	false	none	Lưu lượng tiêu thụ, đơn vị KB

Truy vấn gói dịch vụ

GET Danh sách gói đã mua

GET /end-point/user-product/list

Tham số yêu cầu

Tên	Vị trí	Loại	Bắt buộc	Mô tả
app_key	query	string(password)	Có	Khóa xác thực
trade_no	query	string	Không	Số đơn hàng, vui lòng nhập số đơn hàng đầy đủ. Không hỗ trợ tìm kiếm mờ.
page	query	number	Không	Phân trang, mặc định: 1
size	query	number	Không	Số lượng hiển thị phân trang, mặc định: 20
product_type	query	number	Không	Loại gói dịch vụ

Ví dụ phản hồi

200 Response

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			{
				"id": 0,
				"created_at": "2022-05-13 12:14:15",
				"expired_at": "2022-05-13 12:14:15",
				"product_type": 9,
				"trade_no": "2022051312134339861461465434",
				"order": {
					"created_at": "2022-05-13 12:13:43",
					"pay_at": "2022-05-13 12:13:43",
					"title": "入门级"
				}
			}
		],
		"page": 1,
		"page_size": 20,
		"total_count": 0,
		"total_page": 0
	}
}

Kết quả phản hồi

Mã trạng thái	Ý nghĩa mã trạng thái	Mô tả	Mô hình dữ liệu
200	OK	Yêu cầu thành công	Inline

Cấu trúc dữ liệu phản hồi

Mã trạng thái 200

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
» code	integer	false	none	Mã trạng thái, 200 thành công, 3 app_key không hợp lệ, 156 tài khoản chưa xác thực danh tính
» msg	string	false	none	Thông báo trạng thái
» data	object	false	none	none
»» list	[object]	false	none	none
»»» id	integer	false	none	Mã gói dịch vụ
»»» created_at	string	false	none	Thời gian gói dịch vụ có hiệu lực
»»» expired_at	string	false	none	Thời gian gói dịch vụ hết hạn, sau khi hết hạn lưu lượng không thể sử dụng.
»»» product_type	productTypes	false	none	Loại gói dịch vụ, 9 gói lưu lượng nhà ở động, 11 IP nhà ở động, 14 IP trung tâm dữ liệu tĩnh, 25 IP nhà ở tĩnh
»»» trade_no	string	false	none	Số giao dịch đơn hàng
»»» order	object	false	none	none
»»»» created_at	string	false	none	Thời gian tạo đơn hàng
»»»» pay_at	string	false	none	Thời gian thanh toán đơn hàng
»»»» title	string	false	none	Mô tả đơn hàng
»» page	integer	false	none	Trang hiện tại
»» page_size	integer	false	none	Kích thước trang
»» total_count	integer	false	none	Tổng số bản ghi
»» total_page	integer	false	none	Tổng số trang

Giá trị liệt kê

Thuộc tính	Giá trị
product_type	9
product_type	11
product_type	14
product_type	25

Trích xuất IP

GET Trích xuất IP

GET /end-point/ip/v3

Tham số yêu cầu

Tên	Vị trí	Loại	Bắt buộc	Mô tả
app_key	query	string(password)	Không	Khóa truy cập
cc	query	string	Không	Quốc gia hoặc khu vực
state	query	string	Không	Tỉnh hoặc bang
city	query	string	Không	Thành phố
format	query	string	Không	Định dạng lấy
lb	query	string	Không	Ký tự phân cách, chỉ có hiệu lực với định dạng text
num	query	number	Không	Số lượng trích xuất
life	query	number	Không	Chu kỳ duy trì - phút
ep	query	string	Không	Mạng proxy

Ví dụ phản hồi

200 Response

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			[
				"150.109.114.72:1140",
				"150.109.114.72:1141",
				"150.109.114.72:1142",
				"150.109.114.72:1143",
				"150.109.114.72:1144",
				"150.109.114.72:1145",
				"150.109.114.72:1146",
				"150.109.114.72:1147",
				"150.109.114.72:1148",
				"150.109.114.72:1149"
			]
		]
	}
}

Kết quả phản hồi

Mã trạng thái	Ý nghĩa mã trạng thái	Mô tả	Mô hình dữ liệu
200	OK	Yêu cầu thành công	Inline

Cấu trúc dữ liệu phản hồi

Mã trạng thái 200

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
» code	integer	false	none	Mã trạng thái, 200 thành công, 3 app_key không hợp lệ, 156 tài khoản chưa xác thực danh tính
» msg	string	false	none	Thông báo trạng thái
» data	object	false	none	none
»» list	[any]	false	none	none

GET Danh sách thành phố

GET /end-point/ip/dynamic-citys

Ví dụ phản hồi

200 Response

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			{
				"name_zh_cn": "美国",
				"name_en": "United States",
				"continent_code": "NA",
				"country_code": "US",
				"items": [
					{
						"city": null,
						"state": null,
						"continent_code": null,
						"country_code": null
					}
				]
			}
		]
	}
}

Kết quả phản hồi

Mã trạng thái	Ý nghĩa mã trạng thái	Mô tả	Mô hình dữ liệu
200	OK	Yêu cầu thành công	Inline

Cấu trúc dữ liệu phản hồi

Mã trạng thái 200

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
» code	integer	false	none	Mã trạng thái, 200 thành công, 3 app_key không hợp lệ, 156 tài khoản chưa xác thực danh tính
» msg	string	false	none	Thông báo trạng thái
» data	object	false	none	none
»» list	[object]	false	none	Danh sách
»»» name_zh_cn	string	false	none	Tên quốc gia hoặc khu vực
»»» name_en	string	false	none	Tên quốc gia hoặc khu vực
»»» continent_code	string	false	none	Mã châu lục
»»» country_code	string	false	none	Mã quốc gia hoặc khu vực
»»» items	[object]	false	none	Tỉnh hoặc bang
»»»» city	string	false	none	Tên thành phố
»»»» state	string	false	none	Mã tên tỉnh hoặc bang
»»»» continent_code	string	false	none	Mã châu lục
»»»» country_code	string	false	none	Mã quốc gia hoặc khu vực

GET Tìm kiếm thành phố

GET /end-point/ip/dynamic-citys/search

Tham số yêu cầu

Tên	Vị trí	Loại	Bắt buộc	Mô tả
country_code	query	string	Có	Mã quốc gia hoặc khu vực
state	query	string	Có	Mã bang hoặc tỉnh

Ví dụ phản hồi

200 Response

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": ["string"]
	}
}

Kết quả phản hồi

Mã trạng thái	Ý nghĩa mã trạng thái	Mô tả	Mô hình dữ liệu
200	OK	Yêu cầu thành công	Inline

Cấu trúc dữ liệu phản hồi

Mã trạng thái 200

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
» code	integer	false	none	Mã trạng thái, 200 thành công, 3 app_key không hợp lệ, 156 tài khoản chưa xác thực danh tính
» msg	string	false	none	Thông báo trạng thái
» data	object	false	none	none
»» list	[string]	false	none	Danh sách

GET Danh sách bang

GET /end-point/ip/dynamic-states

Ví dụ phản hồi

200 Response

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			{
				"name_zh_cn": "美国",
				"name_en": "United States",
				"continent_code": "NA",
				"country_code": "US",
				"items": [
					{
						"state": null,
						"continent_code": null,
						"country_code": null
					}
				]
			}
		]
	}
}

Kết quả phản hồi

Mã trạng thái	Ý nghĩa mã trạng thái	Mô tả	Mô hình dữ liệu
200	OK	Yêu cầu thành công	Inline

Cấu trúc dữ liệu phản hồi

Mã trạng thái 200

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
» code	integer	false	none	Mã trạng thái, 200 thành công, 3 app_key không hợp lệ, 156 tài khoản chưa xác thực danh tính
» msg	string	false	none	Thông báo trạng thái
» data	object	false	none	none
»» list	[object]	false	none	Danh sách
»»» name_zh_cn	string	false	none	Tên quốc gia hoặc khu vực
»»» name_en	string	false	none	Tên quốc gia hoặc khu vực
»»» continent_code	string	false	none	Mã châu lục
»»» country_code	string	false	none	Mã quốc gia hoặc khu vực
»»» items	[object]	false	none	Tỉnh hoặc bang
»»»» state	string	false	none	Mã tên tỉnh hoặc bang
»»»» continent_code	string	false	none	Mã châu lục
»»»» country_code	string	false	none	Mã quốc gia hoặc khu vực

GET Tìm kiếm bang/tỉnh

GET /end-point/ip/dynamic-states/search

Tham số yêu cầu

Tên	Vị trí	Loại	Bắt buộc	Mô tả
country_code	query	string	Có	Mã quốc gia hoặc khu vực

Ví dụ phản hồi

200 Response

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": ["string"]
	}
}

Kết quả phản hồi

Mã trạng thái	Ý nghĩa mã trạng thái	Mô tả	Mô hình dữ liệu
200	OK	Yêu cầu thành công	Inline

Cấu trúc dữ liệu phản hồi

Mã trạng thái 200

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
» code	integer	false	none	Mã trạng thái, 200 thành công, 3 app_key không hợp lệ, 156 tài khoản chưa xác thực danh tính
» msg	string	false	none	Thông báo trạng thái
» data	object	false	none	none
»» list	[string]	false	none	Danh sách

GET Trích xuất danh sách IP tĩnh đã mua

GET /end-point/ip/get-static-ip

Tham số yêu cầu

Tên	Vị trí	Loại	Bắt buộc	Mô tả
country_code	query	string	Không	Mã quốc gia hoặc khu vực
product_type	query	number	Không	Loại sản phẩm, 25: IP nhà ở tĩnh, 14: IP trung tâm dữ liệu
trade_no	query	string	Không	Lọc IP theo số đơn hàng
page	query	number	Không	Số trang
size	query	number	Không	Số lượng mỗi trang
status	query	number	Không	Trạng thái, 1: có hiệu lực, 2: không hiệu lực, 3: sắp hết hạn, 4: đang bảo trì

Giá trị liệt kê

Thuộc tính	Giá trị
product_type	14
product_type	25
status	1
status	2
status	3
status	4

Ví dụ phản hồi

200 Response

{}

Kết quả phản hồi

Mã trạng thái	Ý nghĩa mã trạng thái	Mô tả	Mô hình dữ liệu
200	OK	none	Inline

Cấu trúc dữ liệu phản hồi

GET Lấy số lượng IP tĩnh theo khu vực đang bán

GET /end-point/static-ip-region

Tham số yêu cầu

Tên	Vị trí	Loại	Bắt buộc	Mô tả
isp	query	string	Không	Loại IP

Mô tả loại IP

Loại IP	Mô tả
1	IP tĩnh nhà ở gia đình
0	IP tĩnh trung tâm dữ liệu

Ví dụ phản hồi

200 Response

{
	"code": 200,
	"msg": "请求成功",
	"data": {
		"list": [
			{
				"code": "US",
				"number": 55
			}
		]
	}
}

Kết quả phản hồi

Mã trạng thái	Ý nghĩa mã trạng thái	Mô tả	Mô hình dữ liệu
200	OK	none	Inline

Cấu trúc dữ liệu phản hồi

Mã trạng thái 200

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
» code	integer	false	none	Mã trạng thái, 200 thành công
» msg	string	false	none	Thông báo trạng thái
» data	object	false	none	none
»» list	[object]	false	none	none
»»» code	string	false	none	Mã quốc gia hoặc khu vực
»»» number	integer	false	none	Số lượng

Quản lý đơn hàng

GET Danh sách đơn hàng

GET /end-point/order/list

Tham số yêu cầu

Tên	Vị trí	Loại	Bắt buộc	Mô tả
page_no	query	integer	Không	none
page_size	query	integer	Không	none
trade_no	query	string	Không	Mã đơn hàng
status	query	integer	Không	Trạng thái đơn hàng
product_type	query	integer	Không	Loại sản phẩm

Mô tả chi tiết

status: Trạng thái đơn hàng

Trạng thái	Mô tả
0	Chờ thanh toán
1	Đã thanh toán
2	Đã hủy do quá thời gian chưa thanh toán
3	Đã hoàn tiền

product_type: Loại sản phẩm

Loại sản phẩm	Mô tả
3	Nạp tiền số dư
9	Gói lưu lượng động
11	Gói theo thời gian toàn cầu động V2
12	Gói lưu lượng IDC dài hạn
13	Gói lưu lượng IP tĩnh nhà ở
14	Gói IP tĩnh trung tâm dữ liệu
15	Gói lưu lượng ISP dài hạn
16	Gói lưu lượng tĩnh
17	Gói số lượng IP động
18	web-scraper
19	Gia hạn IP tĩnh
20	Hạn ngạch thay đổi IP tĩnh
21	Gói lưu lượng tĩnh v2
24	Gói bổ sung lưu lượng tĩnh
25	Gói IP tĩnh nhà ở
26	Đơn bổ sung - Một số kênh thanh toán yêu cầu người dùng điền số tiền thủ công, ví dụ: tiền ảo, nếu thiếu tiền, cần liên hệ dịch vụ khách hàng để thanh toán bổ sung thông qua loại sản phẩm này
27	Serp
28	Video

Giá trị liệt kê

Thuộc tính	Giá trị
status	0
status	1
status	2
status	3
product_type	3
product_type	9
product_type	11
product_type	12
product_type	14
product_type	16
product_type	17
product_type	18
product_type	19
product_type	21
product_type	24
product_type	25
product_type	26
product_type	27
product_type	28

Ví dụ phản hồi

200 Response

{
	"code": 0,
	"message": "操作成功",
	"data": {
		"list": [
			{
				"id": 0,
				"trade_no": "string",
				"product_id": 0,
				"product_name": "string",
				"total_fee": 0.1,
				"pay_fee": 0.1,
				"status": 0,
				"created_at": "2019-08-24T14:15:22Z"
			}
		],
		"pagination": {
			"total": 0,
			"page_no": 0,
			"page_size": 0,
			"total_pages": 0
		}
	}
}

Kết quả phản hồi

Mã trạng thái	Ý nghĩa mã trạng thái	Mô tả	Mô hình dữ liệu
200	OK	Thành công	Inline

{
	"pid": x, // Liên hệ dịch vụ khách hàng để lấy
	"upids": "1,2,3,4,5,6", // Lấy ID tương ứng từ /end-point/ip/get-static-ip
	"pm_id": 1 // Lấy từ /end-point/payment/list
	"coupon_sn: "xxx", // Tùy chọn - Mã giảm giá
  }

Body Tham số yêu cầu

{
	"pid": 0,
	"upids": "string",
	"amount": 0,
	"pm_id": 0,
	"region_list": "string",
	"coupon_sn": "string",
	"use_invitation_registration_discount": true,
	"renew_duration": 0,
	"product_sku_bandwidth_id": 0,
	"product_sku_concurrency_id": 0,
	"recharge_amount": 0
}

Tham số yêu cầu

Tên	Vị trí	Loại	Bắt buộc	Mô tả
body	body	object	Có	none
» pid	body	integer	Có	ID gói dịch vụ
» upids	body	string	Không	Danh sách ID gói gia hạn
» amount	body	number	Không	Số lượng gói mua mới
» pm_id	body	integer	Có	ID phương thức thanh toán
» region_list	body	string	Không	Chỉ định khu vực + số lượng khi mua IP tĩnh
» coupon_sn	body	string	Không	Mã phiếu giảm giá
» use_invitation_registration_discount	body	boolean	Không	Có sử dụng ưu đãi đăng ký mời hay không
» renew_duration	body	integer	Không	Thời hạn gia hạn - tùy chọn cho IP tĩnh
» product_sku_bandwidth_id	body	integer	Không	Gói 11: ID gói băng thông
» product_sku_concurrency_id	body	integer	Không	Gói 11: ID gói đồng thời
» recharge_amount	body	integer	Không	Gói 3: Số tiền nạp

Ví dụ phản hồi

200 Response

{
	"code": 0,
	"message": "操作成功",
	"data": {
		"id": 0,
		"trade_no": "string",
		"product_id": 0,
		"product_name": "string",
		"total_fee": 0.1,
		"pay_fee": 0.1,
		"status": 0,
		"created_at": "2019-08-24T14:15:22Z"
	}
}

Kết quả phản hồi

Mã trạng thái	Ý nghĩa mã trạng thái	Mô tả	Mô hình dữ liệu
200	OK	Tạo thành công	Inline

Cấu trúc dữ liệu phản hồi

POST Hủy đơn hàng

POST /end-point/order/close

Body Tham số yêu cầu

{
	"trade_no": "string"
}

Tham số yêu cầu

Tên	Vị trí	Loại	Bắt buộc	Mô tả
body	body	object	Có	none
» trade_no	body	string	Có	none

Kết quả phản hồi

Mã trạng thái	Ý nghĩa mã trạng thái	Mô tả	Mô hình dữ liệu
200	OK	Thao tác thành công	None

Quản lý người dùng

GET Lấy thông tin người dùng - Chưa mở

GET /end-point/user/info

Ví dụ phản hồi

200 Response

{
	"code": 0,
	"message": "操作成功",
	"data": {
		"id": 0,
		"email": "[email protected]",
		"phone": "string",
		"balance": 0.1,
		"status": 0,
		"is_real_name": true,
		"created_at": "2019-08-24T14:15:22Z"
	}
}

Kết quả phản hồi

Mã trạng thái	Ý nghĩa mã trạng thái	Mô tả	Mô hình dữ liệu
200	OK	Thành công	Inline

Tên	Vị trí	Loại	Bắt buộc	Mô tả
trade_no	query	string	Không	Số đơn hàng - Có thể truyền vào khi cần lấy phương thức thanh toán cụ thể cho một số đơn hàng

Ví dụ phản hồi

200 Response

{
	"code": 0,
	"message": "操作成功",
	"data": {
		"list": [
			{
				"name": "支付方式分组",
				"logos": ["https://example.com/logo1.png", "https://example.com/logo2.png"],
				"items": [
					{
						"id": 1,
						"title": "title1",
						"logo": "https://example.com/logo1.png",
						"group": "online",
						"disabled": false,
						"min": 10,
						"max": 5000
					}
				]
			}
		]
	}
}

Kết quả phản hồi

Mã trạng thái	Ý nghĩa mã trạng thái	Mô tả	Mô hình dữ liệu
200	OK	Lấy thành công	Inline

Cấu trúc dữ liệu phản hồi

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
» code	integer	false	none	Mã trạng thái, 200 thành công, 3 app_key không hợp lệ, 156 tài khoản chưa xác thực danh tính
» msg	string	false	none	Thông báo trạng thái
» data	object	false	none	none
»» name	string	false	none	Tên nhóm
»» logos	string[]	false	none	Danh sách biểu tượng nhóm
»» items	object[]	false	none	Danh sách mục trong nhóm
»»» id	integer	false	none	ID phương thức thanh toán
»»» title	string	false	none	Tên phương thức thanh toán
»»» logo	string	false	none	Logo phương thức thanh toán
»»» group	string	false	none	Định danh nhóm phương thức thanh toán
»»» disabled	boolean	false	none	Có bị vô hiệu hóa hay không (mặc định `false`)
»»» min	number	false	none	Số tiền tối thiểu
»»» max	number	false	none	Số tiền tối đa

Marketing

GET Tỷ lệ tặng tiền khi nạp

GET /end-point/activity/balance-recharge-gift-ratio

Tỷ lệ tặng tiền khi nạp

Ví dụ phản hồi

200 Response

{
	"code": 0,
	"msg": "操作成功",
	"data": {
		"list": [
			{
				"amount": 100,
				"ratio": 1.2
			}
		]
	}
}

Kết quả phản hồi

Mã trạng thái	Ý nghĩa mã trạng thái	Mô tả	Mô hình dữ liệu
200	OK	OK	Inline

Cấu trúc dữ liệu phản hồi

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
» code	integer	false	none	Mã trạng thái, 200 thành công, 3 app_key không hợp lệ, 156 tài khoản chưa xác thực danh tính
» msg	string	false	none	Thông báo trạng thái
» data	object	false	none	none
» list	[object]	false	none	none
»» amount	integer	false	none	Số tiền nạp
»» ratio	number	false	none	Tỷ lệ nạp

Mô tả cấu trúc dữ liệu (Schemas)

productTypes (Loại gói dịch vụ)

Trường	Loại	Mô tả
product_type	integer	Loại gói dịch vụ

Mô tả giá trị tùy chọn:

Giá trị	Ý nghĩa
9	Gói lưu lượng nhà ở động
11	IP nhà ở động
14	IP trung tâm dữ liệu tĩnh
25	IP nhà ở tĩnh

API Key (Khóa xác thực)

Dùng để xác thực danh tính giao diện, vui lòng truyền qua tham số Query.

Tên tham số	Vị trí	Loại	Bắt buộc	Mô tả
app_key	query	string	Có	Khóa xác thực

Trường phản hồi chung

responseCode

Trường	Loại	Ví dụ	Mô tả
code	integer	200	Mã trạng thái (200 thành công, 3 biểu thị app_key không hợp lệ)

responseMsg

Trường	Loại	Ví dụ	Mô tả
message	string	success	Thông tin phản hồi

Phản hồi thành công (SuccessResponse)

{
	"code": 0,
	"message": "操作成功",
	"data": {}
}

Phản hồi lỗi (ErrorResponse)

{
	"code": 400,
	"message": "参数错误",
	"errors": {}
}

User

{
	"id": 0,
	"email": "[email protected]",
	"phone": "string",
	"balance": 0.1,
	"status": 0,
	"is_real_name": true,
	"created_at": "2019-08-24T14:15:22Z"
}

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
id	integer	false	none	none
email	string(email)	false	none	none
phone	string	false	none	none
balance	number(float)	false	none	none
status	integer	false	none	none
is_real_name	boolean	false	none	none
created_at	string(date-time)	false	none	none

Order

{
	"id": 0,
	"trade_no": "string",
	"product_id": 0,
	"product_name": "string",
	"total_fee": 0.1,
	"pay_fee": 0.1,
	"status": 0,
	"created_at": "2019-08-24T14:15:22Z"
}

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
id	integer	false	none	none
trade_no	string	false	none	none
product_id	integer	false	none	none
product_name	string	false	none	none
total_fee	number(float)	false	none	none
pay_fee	number(float)	false	none	none
status	integer	false	none	none
created_at	string(date-time)	false	none	none

Product

{
	"id": 0,
	"name": "string",
	"type": 0,
	"price": 0.1,
	"description": "string"
}

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
id	integer	false	none	none
name	string	false	none	none
type	integer	false	none	none
price	number(float)	false	none	none
description	string	false	none	none

WhiteIp

{
	"id": 0,
	"ip": "string",
	"remark": "string",
	"created_at": "2019-08-24T14:15:22Z"
}

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
id	integer	false	none	none
ip	string	false	none	none
remark	string	false	none	none
created_at	string(date-time)	false	none	none

WhitelistAccount

{
	"id": 0,
	"username": "string",
	"limit": 0,
	"used": 0,
	"status": 0
}

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
id	integer	false	none	none
username	string	false	none	none
limit	integer	false	none	none
used	integer	false	none	none
status	integer	false	none	none

Coupon

{
	"id": 0,
	"name": "string",
	"code": "string",
	"discount": 0.1,
	"expire_time": "2019-08-24T14:15:22Z"
}

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
id	integer	false	none	none
name	string	false	none	none
code	string	false	none	none
discount	number(float)	false	none	none
expire_time	string(date-time)	false	none	none

Article

{
	"id": 0,
	"title": "string",
	"content": "string",
	"created_at": "2019-08-24T14:15:22Z"
}

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
id	integer	false	none	none
title	string	false	none	none
content	string	false	none	none
created_at	string(date-time)	false	none	none

Pagination

{
	"total": 0,
	"page_no": 0,
	"page_size": 0,
	"total_pages": 0
}

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
total	integer	false	none	none
page_no	integer	false	none	none
page_size	integer	false	none	none
total_pages	integer	false	none	none