OpenAPI

Vui lòng đăng nhập để xem khóa xác thực app_key trên trang chủ trung tâm cá nhân.

Vui lòng bảo mật khóa của bạn, khóa này có quyền quản trị viên đối với tài khoản của bạn.

URL cơ sở:

Xác thực

Quản lý tài khoản đại lý

Lấy danh sách tài khoản proxy

GET /openapi/whitelist-account/list

Ví dụ trả về

Phản hồi 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
			}
		]
	}
}

Kết quả trả về

Mã trạng thái	Ý nghĩa mã trạng thái	Giải thích	Mô hình dữ liệu
200	OK	Yêu cầu thành công	Nội tuyến

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

Mã trạng thái 200

Tên	Loại	Bắt buộc	Ràng buộc	Giải thích
» code	responseCode	false	không có	Mã trạng thái, 200 thành công, 3 app_key không hợp lệ
» msg	chuỗi	sai	không có	Tin nhắn trạng thái
» dữ liệu	đối tượng	sai	không có gì	không có gì
»» danh sách	[đối tượng]	sai	không có	không có
»»» id	số nguyên	sai	không có	Số tài khoản
»»» tên người dùng	chuỗi	sai	không có	Tên tài khoản proxy
»»» mật khẩu	chuỗi	sai	không có	Mật khẩu tài khoản proxy
»»» created_at	chuỗi	sai	không có	Thời gian thêm
»»» Nhận xét	chuỗi	sai	không có	Ghi chú
»»» product_type	productTypes	sai	không có	Loại gói, 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
»»» usage_flow	số nguyên	sai	không có	Lưu lượng đã sử dụng, đơn vị: KB
»»» limit_flow	Số nguyên	Sai	Không có	Giới hạn lưu lượng tùy chỉnh: Đơn vị GB, tối đa 102400, 0 là không giới hạn
»»» status	integer	false	không có	Trạng thái kích hoạt: 1 kích hoạt, 0 tắt

Giá trị enum

Thuộc tính	Giá trị
loại_sản_phẩm	9
loại_sản_phẩm	11
loại_sản_phẩm	14
product_type	25

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

POST /openapi/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	đối tượng	Không	không có
» app_key	thân máy	chuỗi	Không	Khóa ủy quyền
» tài khoản	nội dung	chuỗi	Không	Mật khẩu tài khoản, vui lòng điền theo định dạng username:password, tài khoản và mật khẩu chỉ hỗ trợ chữ số và chữ cái, cấm nhập bất kỳ ký tự đặc biệt hoặc khoảng trắng nào, dấu hai chấm phân tách tài khoản và mật khẩu. Hỗ trợ thêm hàng loạt, dấu phẩy tiếng Anh (,) phân tách các tài khoản proxy.
» remark	body	string	Không	Mô tả tài khoản đại lý
» product_type	body	productTypes	Không	Loại gói, 9 Gói lưu lượng truy cập nhà ở động, 11 IP nhà ở động, 14 IP trung tâm dữ liệu tĩnh, 25 IP nhà ở tĩnh

Giá trị enum

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

Ví dụ phản hồi

Phản hồi 200

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

Kết quả trả về

Mã trạng thái	Ý nghĩa mã trạng thái	Giải thích	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	Loại	Bắt buộc	Ràng buộc	Mô tả
» code	số nguyên	sai	không có giá trị	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
» tin nhắn	chuỗi	sai	không có	Tin nhắn trạng thái
» data	null	false	không có	không có

POST Xóa tài khoản ủy quyền

POST /openapi/whitelist-account/delete

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

Tham số yêu cầu Body

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

Tham số yêu cầu

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

Ví dụ trả về

Phản hồi 200

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

Kết quả trả về

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	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	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	không có gì	Tin nhắn trạng thái
» dữ liệu	vô giá trị	sai	không có	không có

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

POST /openapi/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 chi phí.

Tham số yêu cầu Body

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

Tham số yêu cầu

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

Ví dụ trả về

Phản hồi 200

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

Kết quả trả về

Mã trạng thái	Ý nghĩa mã trạng thái	Giải thích	Mô hình dữ liệu
200	OK	Yêu cầu thành	Nội tuyến

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

Mã trạng thái 200

Tên	Loại	Bắt buộc	Ràng buộc	Giải thích
» code	số nguyên	sai	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	sai	không có	Tin nhắn trạng thái
» dữ liệu	null	false	none	none

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

POST /openapi/whitelist-account/enable

Tham số yêu cầu Body

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

Tham số yêu cầu

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

Ví dụ trả về

Phản hồi 200

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

Kết quả trả về

Mã trạng thái	Ý nghĩa mã trạng thái	Giải thích	Mô hình dữ liệu
200	OK	Yêu cầu thành	Nội tuyến

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

Mã trạng thái 200

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
» code	số nguyên	sai	không có giá trị	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
» tin nhắn	chuỗi	sai	không có	Tin nhắn trạng thái
» data	null	false	không có	không có

POST Sửa đổi mật khẩu tài khoản đại lý

POST /openapi/whitelist-account/change-password

Xin lưu ý rằng sau khi sửa đổi, bạn phải đợi 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.

Tham số yêu cầu Body

{
	"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ả
thân thể	thân hình	vật thể	Không	không có
» app_key	body	chuỗi	Không	Khóa ủy quyền
» account	body	chuỗi	Không	Tài khoản đại lý, chỉ hỗ trợ chữ và số.
» password	thân	chuỗi	Không	Mật khẩu mới của tài khoản đại lý, chỉ hỗ trợ chữ số và chữ cái.

Ví dụ trả về

Phản hồi 200

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

Kết quả trả về

Mã trạng thái	Mã trạng thái ý nghĩa	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 trả về

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	sai	không có	Tin nhắn trạng thái
» dữ liệu	null	false	none	none

POST Sửa đổi ghi chú tài khoản đại lý

POST /openapi/whitelist-account/change-remark

Tham số yêu cầu Body

{
	"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	không có
» app_key	body	chuỗi	Không	Khóa ủy quyền
» account	thân hình	chuỗi	Không	Tài khoản đại lý, chỉ hỗ trợ chữ số và chữ cái.
» nhận xét	thân	chuỗi	Không	Ghi chú mới cho tài khoản đại lý, tối đa 32 ký tự tiếng Trung hoặc 64 ký tự tiếng Anh.

Ví dụ trả về

Phản hồi 200

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

Kết quả trả về

Mã trạng thái	Mã trạng thái ý nghĩa	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 trả về

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	sai	không có	Tin nhắn trạng thái
» dữ liệu	null	false	none	none

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

POST /openapi/whitelist-account/change-limit

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

Tham số yêu cầu Body

{
	"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	không có
» app_key	body	chuỗi	Không	Khóa ủy quyền
» account	thân	chuỗi	Không	Tài khoản đại lý, chỉ hỗ trợ chữ số và chữ cái.
» giới hạn	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ụ trả về

Phản hồi 200

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

Kết quả trả về

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	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	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	không có gì	Tin nhắn trạng thái
» dữ liệu	vô giá trị	sai	không	không

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

GET Sử dụng lưu lượng truy cập tổng hợp theo ngày

GET /openapi/user-usage-flow/total

Tham số yêu cầu

Tên	Vị trí	Loại	Bắt buộc	Mô tả
app_key	truy vấn	string(mật khẩu)	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. Xin lưu ý rằng 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. Xin lưu ý rằng nhật ký có độ trễ trong vòng 5 phút. Mặc định là thời gian hiện tại.
username	query	chuỗi	Không	Tên tài khoản phụ, mặc định sẽ tìm kiếm tất cả các tài khoản, có thể chỉ định tài khoản phụ. Xin lưu ý nếu bạn thêm các tài khoản phụ có cùng tên, truy vấn này sẽ trả về tất cả các bản ghi sử dụng của các tài khoản đại lý có cùng tên.
product_type	truy vấn	số	Không	Loại gói

Ví dụ trả về

Phản hồi 200

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

Kết quả trả về

Mã trạng thái	Ý nghĩa mã trạng thái	Giải thích	Mô hình dữ liệu
200	OK	Yêu cầu thành	Nội tuyến

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

Mã trạng thái 200

Tên	Loại	Bắt buộc	Ràng buộc	Giải thích
» code	số nguyên	sai	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	sai	không có	Tin nhắn trạng thái
» dữ liệu	đối tượng	sai	không có gì	không có gì
»» danh sách	[đối tượng]	sai	không có	không có
»»» ngày	chuỗi	sai	không có	Ngày
»»» dòng chảy	số nguyên	sai	không có	Tiêu thụ lưu lượng, đơn vị KB

Truy vấn gói cước

Lấy danh sách gói đã mua

GET /openapi/user-product/list

Tham số yêu cầu

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

Ví dụ trả về

Phản hồi 200

{
	"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ả trả về

Mã trạng thái	Ý nghĩa mã trạng thái	Giải thích	Mô hình dữ liệu
200	OK	Yêu cầu thành	Nội tuyến

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

Mã trạng thái 200

Tên	Loại	Bắt buộc	Ràng buộc	Giải thích
» code	số nguyên	sai	không có giá trị	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
» tin nhắn	chuỗi	sai	không có	Tin nhắn trạng thái
» data	đối tượng	sai	không có	không có
»» danh sách	[đối tượng]	sai	không có	không có
»»» id	số nguyên	sai	không có	Mã gói
»»» created_at	chuỗi	sai	không có	Thời gian gói cước có hiệu lực
»»» expired_at	string	false	không có	Thời gian hết hạn của gói, sau khi hết hạn lưu lượng sẽ không thể sử dụng được.
»»» product_type	productTypes	sai	không có	Loại gói, 9 Gói lưu lượng truy cập nhà ở động, 11 IP nhà ở động, 14 IP trung tâm dữ liệu tĩnh, 25 IP nhà ở tĩnh
»»» trade_no	chuỗi	sai	không có	Mã giao dịch đơn hàng
»»» thứ tự	vật thể	sai	không có	không có
»»»» created_at	chuỗi	sai	none	Thời gian tạo đơn hàng
»»»» pay_at	string	sai	không có	Thời gian thanh toán đơn hàng
»»»» tiêu đề	chuỗi	sai	không có	Mô tả đơn hàng
»» trang	số nguyên	sai	không có	Trang hiện tại
»» page_size	số nguyên	sai	không có	Kích thước trang
»» total_count	số nguyên	sai	không có	Tổng số bản ghi
»» total_page	số nguyên	sai	không có	Tổng số trang

Giá trị enum

Thuộc tính	Giá trị
product_type	9
loại_sản_phẩm	11
loại_sản_phẩm	14
loại_sản_phẩm	25

Trích xuất IP

GET Lấy IP

GET /openapi/ip/v3

Tham số yêu cầu

Tên	Vị trí	Loại	Bắt buộc	Mô tả
app_key	truy vấn	chuỗi(mật khẩu)	Không	Khóa truy cập
cc	truy vấn	chuỗi	Không	Quốc gia hoặc khu vực
tiểu bang	truy vấn	chuỗi	Không	Tỉnh hoặc tiểu bang
thành phố	truy vấn	chuỗi	Không	Thành phố
định dạng	truy vấn	chuỗi	Không	Lấy định dạng
lb	query	string	Không	Dấu 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	số	Không	Chu kỳ duy trì - phút
ep	truy vấn	chuỗi	Không	Mạng lưới proxy

Ví dụ trả về

Phản hồi 200

{
	"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ả trả về

Mã trạng thái	Ý nghĩa mã trạng thái	Giải thích	Mô hình dữ liệu
200	OK	Yêu cầu thành	Nội tuyến

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

Mã trạng thái 200

Tên	Loại	Bắt buộc	Ràng buộc	Giải thích
» code	số nguyên	sai	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	sai	không có	Tin nhắn trạng thái
» dữ liệu	đối tượng	sai	không có gì	không có gì
»» danh sách	[bất kỳ]	sai	không có	không có

LẤY DANH SÁCH THÀNH PHỐ

GET /openapi/ip/dynamic-citys

Ví dụ trả về

Phản hồi 200

{
	"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ả trả về

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	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	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	không có	Tin nhắn trạng thái
» dữ liệu	đối tượng	sai	không có	không có
»» danh sách	[đối tượng]	sai	không có	danh sách
»»» name_zh_cn	chuỗi	sai	không có	Tên quốc gia hoặc khu vực
»»» name_en	chuỗi	sai	không có	Tên quốc gia hoặc khu vực
»»» continent_code	chuỗi	sai	không có	Mã châu lục
»»» country_code	chuỗi	sai	không có	Mã quốc gia hoặc khu vực
»»» các mục	[đối tượng]	sai	không có	Tỉnh hoặc bang
»»»» thành phố	chuỗi	sai	không có	Tên thành phố
»»»» tiểu bang	chuỗi	sai	không có	Mã tên tỉnh hoặc tiểu bang
»»»» continent_code	chuỗi	sai	không có	Mã châu lục
»»»» country_code	chuỗi	sai	không có	Mã quốc gia hoặc khu vực

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

GET /openapi/ip/dynamic-citys/search

Tham số yêu cầu

Tên	Vị trí	Loại	Bắt buộc	Giải thích
mã_quốc_gia	truy vấn	chuỗi	Là	Mã quốc gia hoặc khu vực
tỉnh/thành phố	truy vấn	chuỗi	Là	Mã tiểu bang hoặc tỉnh

Ví dụ trả về

Phản hồi 200

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

Kết quả trả về

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	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	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	không có	Tin nhắn trạng thái
» dữ liệu	đối tượng	sai	không có	không có
»» danh sách	[chuỗi]	sai	không có	danh sách

Lấy danh sách tiểu bang

GET /openapi/ip/dynamic-states

Ví dụ phản hồi

Phản hồi 200

{
	"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ả trả về

Mã trạng thái	Ý nghĩa mã trạng thái	Giải thích	Mô hình dữ liệu
200	OK	Yêu cầu thành công	Nội tuyến

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

Mã trạng thái 200

Tên	Loại	Bắt buộc	Ràng buộc	Mô tả
» code	số nguyên	sai	không có giá trị	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
» tin nhắn	chuỗi	sai	không có	Tin nhắn trạng thái
» data	đối tượng	sai	không có	không có
»» danh sách	[đối tượng]	sai	không có	Danh sách
»»» name_zh_cn	chuỗi	sai	không có	Tên quốc gia hoặc khu vực
»»» name_en	chuỗi	sai	không có	Tên quốc gia hoặc khu vực
»»» continent_code	string	false	không có	Mã châu lục
»»» country_code	chuỗi	sai	không có	Mã quốc gia hoặc khu vực
»»» mục	[đối tượng]	sai	không có	Tỉnh hoặc tiểu bang
»»»» trạng thái	chuỗi	sai	không có	Mã tên tỉnh hoặc tiểu bang
»»»» continent_code	string	false	không có	Mã châu lục
»»»» country_code	chuỗi	sai	không có	Mã quốc gia hoặc khu vực

GET Tìm kiếm tiểu bang/tỉnh

GET /openapi/ip/dynamic-states/search

Tham số yêu cầu

Tên	Vị trí	Loại	Bắt buộc	Mô tả
mã_quốc_gia	truy vấn	chuỗi	là	Mã quốc gia hoặc khu vực

Ví dụ trả về

Phản hồi 200

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

Kết quả trả về

Mã trạng thái	Ý nghĩa mã trạng thái	Giải thích	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	Loại	Bắt buộc	Ràng buộc	Mô tả
» code	integer	sai	không có	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	chuỗi	sai	không có	Thông báo trạng thái
» dữ liệu	đối tượng	sai	không có	không có
»» danh sách	[chuỗi]	sai	không có	Danh sách

GET Lấy danh sách IP tĩnh

GET /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	chuỗi	Không	Mã quốc gia hoặc khu vực
product_type	truy vấn	số lượng	Không	Loại sản phẩm, 25: IP tĩnh dân cư, 14: IP trung tâm dữ liệu
trade_no	query	string	Không	Lọc IP theo số đơn hàng
trang	truy vấn	số	Không	Số trang
Kích thước	Truy vấn	số	Không	Số lượng mỗi trang
trạng thái	truy vấn	số lượng	Không	Trạng thái, 1: Hiệu lực, 2: Vô hiệu, 3: Sắp hết hạn, 4: Đang bảo trì

Giá trị enum

Thuộc tính	Giá trị
product_type	14
loại sản phẩm	25
trạng thái	1
tình trạng	2
thực trạng	3
trạng thái	4

Ví dụ trả về

Phản hồi 200

{}

Kết quả trả về

Mã trạng thái	Ý nghĩa mã trạng thái	Giải thích	Mô hình dữ liệu
200	OK	không có	Nội tuyến

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

Mô hình dữ liệu

productTypes

Loại gói, 9 Gói lưu lượng truy cập nhà ở động, 11 IP nhà ở động, 14 IP trung tâm dữ liệu tĩnh, 25 IP nhà ở tĩnh

Thuộc tính

Tên	Loại	Bắt buộc	Ràng buộc	Tên tiếng Trung	Mô tả
ẩn danh	số nguyên	sai	không có		Loại gói, 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

Giá trị enum

Thuộc tính	Giá trị
ẩn danh	9
ẩn danh	11
ẩn danh	14
ẩn danh	25

apiKey

null

Khóa xác thực

Tên	Loại	Bắt buộc	Ràng buộc	Tên tiếng Trung	Mô tả
ẩn danh	số nguyên	sai	none		Mã trạng thái, 200 thành công, 3 app_key không hợp lệ

responseMsg

"success"

response message

Thuộc tính

Tên	Loại	Bắt buộc	Ràng buộc	Tên tiếng Trung	Mô tả
vô danh	chuỗi	sai	không có		tin nhắn phản hồi