ProxyCC OpenAPI

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

Vui lòng giữ an toàn cho khóa này, vì nó có đặc quyền quản trị viên cho tài khoản của bạn.

URL cơ sở:

https://api.proxy.cc

Phương pháp xác thực

Xác thực Khóa ứng dụng

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 giao diện trả về một định dạng JSON thống nhất:

{
	"code": 200,
	"message": "操作成功",
	"data": {}
}
  • code: Mã trạng thái, 200 cho biết thành công, các giá trị khác cho biết lỗi
  • message: Tin nhắn phản hồi (tiếng Trung)
  • data: Dữ liệu phản hồi

Xác thực

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

1. Bearer Token（JWT）

Truyền Token qua HTTP Header.

Ví dụ Header:

Authorization: Bearer <your_jwt_token>

Xác thực bằng API Key

Giao diện này sử dụng phương thức API Key để xác thực.

Khách hàng cần đưa tham số app_key vào yêu cầu, 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 Proxy

LẤY Danh sách tài khoản Proxy

GET /open/whitelist-account/list

Ví dụ trả về

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
			}
		]
	}
}

Kết quả trả về

Mã trạng tháiÝ nghĩa mã trạng tháiMô tảMô hình dữ liệu
200OKYêu cầu thành côngNội tuyến

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

Mã trạng thái 200

TênLoạiBắt buộcRàng buộcTên tiếng TrungMô tả
» coderesponseCodesaikhông cóMã trạng thái, 200 thành công, 3 app_key không hợp lệ
» tin nhắnchuỗisaikhông cóThông báo trạng thái
» datađối tượngsaikhông cókhông có
»» danh sách[đối tượng]saikhông cókhông có
»»» idsố nguyênsaikhông cóSố tài khoản
»»» tên người dùngchuỗisaikhông cóTên tài khoản đại lý
»»» mật khẩuchuỗisaikhông cóMật khẩu tài khoản đại lý
»»» created_atchuỗisaikhông cóThời gian thêm
»»» nhận xétchuỗisaikhông cóGhi chú
»»» product_typeproductTypessaikhông cóLoại gói, Gói cước lưu lượng dân cư động 9, IP dân cư động 11, IP trung tâm dữ liệu tĩnh 14, IP dân cư tĩnh 25
»»» usage_flowsố nguyênsaikhông cóLưu lượng đã sử dụng, Đơn vị: KB
»»» limit_flowsố nguyênsaikhô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
»»» statussố nguyênsaikhông cóTrạng thái kích hoạt: 1 là bật, 0 là tắt

Giá trị Enum

Thuộc tínhGiá trị
product_type9
product_type11
product_type14
product_type25

POST Thêm Tài khoản Proxy

POST /open/whitelist-account/add

Tham số yêu cầu thân

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

Tham số yêu cầu

TênVị tríLoạiBắt buộcMô tả
bodybodyđối tượngKhôngkhông có
» app_keybodychuỗiKhôngKhóa ủy quyền
» accountsbodychuỗiKhôngMật khẩu tài khoản, vui lòng điền theo định dạng username:password. Chỉ hỗ trợ số và chữ cái cho tài khoản và mật khẩu. Không nhập bất kỳ ký tự đặc biệt hoặc khoảng trắng nào. Phân tách tài khoản và mật khẩu bằng dấu hai chấm. Hỗ trợ thêm hàng loạt và các tài khoản proxy được phân tách bằng dấu phẩy tiếng Anh (,).
» remarkbodychuỗiKhôngMô tả tài khoản proxy
» product_typebodyproductTypesKhôngLoại gói, Gói lưu lượng truy cập khu dân cư động 9, IP khu dân cư động 11, IP trung tâm dữ liệu tĩnh 14, IP khu dân cư tĩnh 25

Giá trị Enum

Thuộc tínhGiá trị
» product_type9
» product_type11
» product_type14
» product_type25

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áiMô tảMô hình dữ liệu
200OKYêu cầu thành côngNội tuyến

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

Mã trạng thái 200

TênLoạiBắt buộcRàng buộcTên tiếng TrungMô tả
» codesố nguyênsaikhô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 tên thật
» tin nhắnchuỗisaikhông cóThông báo trạng thái
» datanullsaikhông cókhông có

POST Xóa Tài khoản Proxy

POST /open/whitelist-account/delete

Xin lưu ý rằng việc xóa là không thể đảo ngược và lưu lượng đã sử dụng cũng như các dữ liệu khác không thể được truy vấn sau khi xóa. Quá trình xóa mất khoảng 5 phút và có thể vẫn phát sinh phí trong thời gian này.

Tham số yêu cầu thân

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

Tham số yêu cầu

TênVị tríLoạiBắt buộcMô tả
bodybodyđối tượngKhôngkhông có
» app_keybodychuỗiKhôngAuthorization Key
» accountsbodychuỗiKhôngTà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 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áiMô tảMô hình dữ liệu
200OKYêu cầu thành côngNội tuyến

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

Mã trạng thái 200

TênLoạiBắt buộcRàng buộcTên tiếng TrungMô tả
» codesố nguyênsaikhô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 tên thật
» tin nhắnchuỗisaikhông cóThông báo trạng thái
» datanullsaikhông cókhông có

POST Vô hiệu hóa Tài khoản Proxy

POST /open/whitelist-account/disable

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

Tham số Yêu cầu Body

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

Tham số yêu cầu

TênVị tríLoạiBắt buộcMô tả
bodybodyđối tượngKhôngkhông có
» app_keybodychuỗiKhôngKhóa ủy quyền
» accountsbodychuỗiKhôngTà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 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áiMô tảMô hình dữ liệu
200OKYêu cầu thành côngNội tuyến

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

Mã trạng thái 200

TênLoạiBắt buộcRàng buộcTên tiếng TrungGiải thích
» codesố nguyênsaikhô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 tên thật
» tin nhắnchuỗisaikhông cóThông báo trạng thái
» datanullsaikhông cókhông có

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

POST /open/whitelist-account/enable

Tham số Yêu cầu Body

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

Tham số Yêu cầu

TênVị tríLoạiYêu cầuMô tả
bodybodyđối tượngKhôngkhông có
» app_keybodychuỗiKhôngKhóa ủy quyền
» accountsbodychuỗiKhôngTà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 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áiMô tảMô hình dữ liệu
200OKYêu cầu thành côngNội tuyến

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

Mã trạng thái 200

TênLoạiBắt buộcRàng buộcTên tiếng TrungMô tả
» codesố nguyênsaikhô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 tên thật
» tin nhắnchuỗisaikhông cóThông báo trạng thái
» datanullsaikhông cókhông có

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

POST /open/whitelist-account/change-password

Xin lưu ý rằng có thời gian chờ 5 phút sau khi sửa đổi, trong thời gian đó 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ênVị tríLoạiYêu cầuMô tả
bodybodyđối tượngKhôngkhông có
» app_keybodychuỗiKhôngKhóa ủy quyền
» tài khoảnbodychuỗiKhôngTài khoản proxy, chỉ hỗ trợ số và chữ cái.
» passwordbodychuỗiKhôngMật khẩu mới cho tài khoản proxy, chỉ hỗ trợ 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Ý nghĩa mã trạng tháiMô tảMô hình dữ liệu
200OKYêu cầu thành côngNội tuyến

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

Mã trạng thái 200

TênLoạiBắt buộcRàng buộcTên tiếng TrungMô tả
» codesố nguyênsaikhô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 tên thật
» tin nhắnchuỗisaikhông cóThông báo trạng thái
» datanullsaikhông cókhông có

POST Sửa đổi ghi chú tài khoản proxy

POST /open/whitelist-account/change-remark

Tham số yêu cầu thân

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

Tham số yêu cầu

TênVị tríLoạiBắt buộcMô tả
bodybodyđối tượngKhôngkhông có
» app_keybodychuỗiKhôngKhóa ủy quyền
» tài khoảnbodychuỗiKhôngTài khoản proxy, chỉ hỗ trợ số và chữ cái.
» remarkbodychuỗiKhôngLưu ý tài khoản đại lý mới, trong vòng 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Ý nghĩa mã trạng tháiMô tảMô hình dữ liệu
200OKYêu cầu thành côngNội tuyến

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

Mã trạng thái 200

TênLoạiBắt buộcRàng buộcTên tiếng TrungMô tả
» codesố nguyênsaikhô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 tên thật
» tin nhắnchuỗisaikhông cóThông báo trạng thái
» datanullsaikhông cókhông có

POST Sửa đổi Giới hạn Lưu lượng Truy cập Tài khoản Đại lý

POST /open/whitelist-account/change-limit

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

Tham số yêu cầu phần thân

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

Tham số yêu cầu

TênVị tríLoạiYêu cầuMô tả
bodybodyđối tượngKhôngkhông có
» app_keybodychuỗiKhôngKhóa ủy quyền
» tài khoảnbodychuỗiKhôngTài khoản proxy, chỉ hỗ trợ số và chữ cái.
» limitbodysố nguyênKhôngGiới hạn lưu lượng, đơn vị: GB, 0 nghĩa 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áiMô tảMô hình dữ liệu
200OKYêu cầu thành côngNội tuyến

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

Mã trạng thái 200

TênLoạiBắt buộcRàng buộcTên tiếng TrungMô tả
» codesố nguyênsaikhô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 tên thật
» tin nhắnchuỗisaikhông cóThông báo trạng thái
» datanullsaikhông cókhông có

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

Lấy Lưu lượng Sử dụng được Tổng hợp theo Ngày

GET /open/user-usage-flow/total

Tham số Yêu cầu

TênVị tríLoạiYêu cầuMô tả
app_keytruy vấnstring(password)CóKhóa xác thực
thời_gian_bắt_đầutruy vấnChuỗi (Y-m-d H:i:s)KhôngThời gian bắt đầu, chính xác đến giây. Xin lưu ý rằng có thể có độ trễ lên đến 5 phút trong việc ghi nhật ký. Mặc định trong vòng 7 ngày.
Thời gian kết thúctruy vấnChuỗi (Y-m-d H:i:s)KhôngThời gian kết thúc, chính xác đến giây. Xin lưu ý rằng có thể có độ trễ lên đến 5 phút trong việc ghi nhật ký. Mặc định là thời gian hiện tại.
Tên người dùngtruy vấnchuỗiKhôngTên tài khoản phụ, mặc định là truy vấn tất cả các tài khoản, có thể chỉ định một tài khoản phụ. Xin lưu ý rằng 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 cho các tài khoản proxy có cùng tên.
product_typetruy vấnsốKhôngLoạ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áiMô tảMô hình dữ liệu
200OKYêu cầu thành côngNội tuyến

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

Mã trạng thái 200

TênLoạiBắt buộcRàng buộcTên tiếng TrungMô tả
» codesố nguyênsaikhô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 tên thật
» tin nhắnchuỗisaikhông cóThông báo trạng thái
» datađối tượngsaikhông cókhông có
»» danh sách[đối tượng]saikhông cókhông có
»»» ngàychuỗisaikhông cóNgày
»»» flowsố nguyênsaikhông cóMức tiêu thụ lưu lượng, đơn vị: KB

Yêu cầu gói

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

GET /open/user-product/list

Tham số yêu cầu

TênVị tríLoạiYêu cầuMô tả
app_keytruy vấnstring(password)CóKhóa xác thực
trade_notruy vấnchuỗiKhôngSố đơn hàng, vui lòng nhập đầy đủ số đơn hàng. Không hỗ trợ tìm kiếm gần đúng.
trangtruy vấnsốKhôngPhân trang, mặc định: 1
kích thướctruy vấnsốKhôngSố lượng mục trên mỗi trang, mặc định: 20
product_typetruy vấnsốKhôngLoạ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áiMô tảMô hình dữ liệu
200OKYêu cầu thành côngNội tuyến

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

Mã trạng thái 200

TênLoạiBắt buộcRàng buộcTên tiếng TrungMô tả
» codesố nguyênsaikhô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 tên thật
» tin nhắnchuỗisaikhông cóThông báo trạng thái
» datađối tượngsaikhông cókhông có
»» danh sách[đối tượng]saikhông cókhông có
»»» idsố nguyênsaikhông cóSố gói
»»» created_atchuỗisaikhông cóThời gian kích hoạt gói
»»» expired_atchuỗisaikhông cóThời gian hết hạn gói, sau khi hết hạn lưu lượng sẽ không thể sử dụng được.
»»» product_typeLoại sản phẩmsaikhông cóLoại gói, Gói lưu lượng truy cập dân cư động 9, IP dân cư động 11, IP trung tâm dữ liệu tĩnh 14, IP dân cư tĩnh 25
»»» trade_nochuỗisaikhông cóSố giao dịch đơn hàng
»»» đơn hàngđối tượngsaikhông cókhông có
»»»» created_atchuỗisaikhông cóThời gian tạo đơn hàng
»»»» pay_atchuỗisaikhông cóThời gian thanh toán đơn hàng
»»»» tiêu đềchuỗisaikhông cóMô tả đơn hàng
»» trangsố nguyênsaikhông cóTrang hiện tại
»» page_sizesố nguyênsaikhông cóKích thước trang
»» total_countsố nguyênsaikhông cóTổng số bản ghi
»» total_pagesố nguyênsaikhông cóTổng số trang

Giá trị Enum

Thuộc tínhGiá trị
product_type9
product_type11
product_type14
product_type25

Trích xuất IP

GET Trích xuất IP

GET /open/ip/v3

Tham số yêu cầu

TênVị tríLoạiBắt buộcMô tả
app_keytruy vấnstring(password)KhôngKhóa truy cập
cctruy vấnchuỗiKhôngQuốc gia hoặc Vùng
statetruy vấnchuỗiKhôngTiểu bang hoặc Tỉnh/Thành phố
Thành phốtruy vấnchuỗiKhôngThành phố
định dạngtruy vấnchuỗiKhôngLấy Định Dạng
lbtruy vấnchuỗiKhôngDấu phân cách, chỉ hợp lệ với định dạng văn bản
numtruy vấnsốKhôngSố lượng trích xuất
cuộc sốngtruy vấnsốKhôngGiữ chu kỳ - Phút
eptruy vấnchuỗiKhôngMạ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áiMô tảMô hình dữ liệu
200OKYêu cầu thành côngNội tuyến

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

Mã trạng thái 200

TênLoạiBắt buộcRàng buộcTên tiếng TrungMô tả
» codesố nguyênsaikhô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 tên thật
» tin nhắnchuỗisaikhông cóThông báo trạng thái
» datađối tượngsaikhông cókhông có
»» danh sách[bất kỳ]saikhông cókhông có

Lấy Danh Sách Thành Phố

GET /open/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áiMô tảMô hình dữ liệu
200OKYêu cầu thành côngNội tuyến

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

Mã trạng thái 200

TênLoạiBắt buộcRàng buộcTên tiếng TrungMô tả
» codesố nguyênsaikhô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 tên thật
» tin nhắnchuỗisaikhông cóThông báo trạng thái
» datađối tượngsaikhông cókhông có
»» danh sách[đối tượng]saikhông cóDanh sách
»»» name_zh_cnchuỗisaikhông cóTên quốc gia hoặc khu vực
»»» name_vichuỗisaikhông cóTên quốc gia hoặc khu vực
»»» continent_codechuỗisaikhông cóMã châu lục
»»» country_codechuỗisaikhông cóMã quốc gia hoặc khu vực
»»» items[đối tượng]saikhông cóTiểu bang hoặc Tỉnh/Thành phố
»»»» thành phốchuỗisaikhông cóTên thành phố
»»»» statechuỗisaikhông cóMã tỉnh hoặc tiểu bang
»»»» continent_codechuỗisaikhông cóMã châu lục
»»»» country_codechuỗisaikhông cóMã quốc gia hoặc khu vực

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

GET /open/ip/dynamic-citys/search

Tham số yêu cầu

TênVị tríLoạiBắt buộcMô tả
mã_quốc_giatruy vấnchuỗiĐúngMã quốc gia hoặc khu vực
statetruy vấnchuỗiĐúngMã tiểu bang hoặc tỉnh/thành phố

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áiMô tảMô hình dữ liệu
200OKYêu cầu thành côngNội tuyến

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

Mã trạng thái 200

TênLoạiBắt buộcRàng buộcTên tiếng TrungMô tả
» codesố nguyênsaikhô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 tên thật
» tin nhắnchuỗisaikhông cóThông báo trạng thái
» datađối tượngsaikhông cókhông có
»» danh sách[chuỗi]saikhông cóDanh sách

Lấy danh sách trạng thái

GET /open/ip/dynamic-states

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": [
					{
						"state": null,
						"continent_code": null,
						"country_code": null
					}
				]
			}
		]
	}
}

Kết quả trả về

Mã trạng tháiÝ nghĩa mã trạng tháiMô tảMô hình dữ liệu
200OKYêu cầu thành côngNội tuyến

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

Mã trạng thái 200

TênLoạiBắt buộcRàng buộcTên tiếng TrungMô tả
» codesố nguyênsaikhô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 tên thật
» tin nhắnchuỗisaikhông cóThông báo trạng thái
» datađối tượngsaikhông cókhông có
»» danh sách[đối tượng]saikhông cóDanh sách
»»» name_zh_cnchuỗisaikhông cóTên quốc gia hoặc khu vực
»»» name_vichuỗisaikhông cóTên quốc gia hoặc khu vực
»»» continent_codechuỗisaikhông cóMã châu lục
»»» country_codechuỗisaikhông cóMã quốc gia hoặc khu vực
»»» items[đối tượng]saikhông cóTiểu bang hoặc Tỉnh/Thành phố
»»»» statechuỗisaikhông cóMã tên tỉnh/thành phố hoặc tiểu bang
»»»» continent_codechuỗisaikhông cóMã châu lục
»»»» country_codechuỗisaikhông cóMã quốc gia hoặc khu vực

Tìm kiếm Tiểu bang/Tỉnh

GET /open/ip/dynamic-states/search

Tham số yêu cầu

TênVị tríLoạiBắt buộcMô tả
mã_quốc_giatruy vấnchuỗiCó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áiMô tảMô hình dữ liệu
200OKYêu cầu thành côngNội tuyến

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

Mã trạng thái 200

TênLoạiBắt buộcRàng buộcTên tiếng TrungMô tả
» codesố nguyênsaikhô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 tên thật
» tin nhắnchuỗisaikhông cóThông báo trạng thái
» datađối tượngsaikhông cókhông có
»» danh sách[chuỗi]saikhông cóDanh sách

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

GET /open/ip/get-static-ip

Tham số yêu cầu

TênVị tríLoạiBắt buộcMô tả
mã_quốc_giatruy vấnchuỗiKhôngMã quốc gia hoặc khu vực
product_typetruy vấnsốKhôngLoại sản phẩm, 25: IP tĩnh dân dụng, 14: IP trung tâm dữ liệu
trade_notruy vấnchuỗiKhôngLọc IP theo Số đơn hàng
trangtruy vấnsốKhôngSố trang
kích thướctruy vấnsốKhôngKhổ giấy
trạng tháitruy vấnsốKhôngTrạng thái, 1: hợp lệ, 2: không hợp lệ, 3: sắp hết hạn, 4: đang bảo trì

Giá trị Enum

Thuộc tínhGiá trị
product_type14
product_type25
trạng thái1
trạng thái2
trạng thái3
trạng thái4

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áiMô tảMô hình dữ liệu
200OKkhông cóNội tuyến

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

GET Lấy số lượng IP tĩnh trong khu vực bán hàng

GET /open/static-ip-region

Tham số yêu cầu

TênVị tríLoạiBắt buộcMô tả
isptruy vấnchuỗiKhôngLoại IP

Mô tả loại IP

Loại IPMô tả
1IP Tĩnh Dân Dụng
0IP tĩnh của Trung tâm Dữ liệu

Ví dụ trả về

Phản hồi 200

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

Kết quả trả về

Mã trạng tháiÝ nghĩa mã trạng tháiMô tảMô hình Dữ liệu
200OKkhông cóNội tuyến

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

Mã trạng thái 200

TênLoạiBắt buộcRàng buộcTên tiếng TrungMô tả
» codesố nguyênsaikhông cóMã trạng thái, 200 Thành công
» tin nhắnchuỗisaikhông cóThông báo trạng thái
» datađối tượngsaikhông cókhông có
»» danh sách[đối tượng]saikhông cókhông có
»»» codechuỗisaikhông cóMã quốc gia hoặc khu vực
»»» numbersố nguyênsaikhông cóSố lượng

Quản lý đơn hàng

Lấy danh sách đơn hàng

GET /open/order/list

Tham số yêu cầu

TênVị tríLoạiBắt buộcMô tả
số_trangtruy vấnsố nguyênKhôngkhông có
Kích thước trangtruy vấnsố nguyênKhôngkhông có
trade_notruy vấnchuỗiKhôngSố đơn hàng
trạng tháitruy vấnsố nguyênKhôngTrạng thái đơn hàng
product_typetruy vấnsố nguyênKhôngLoại sản phẩm

Mô tả chi tiết

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

Trạng tháiMô tả
0Đang chờ thanh toán
1Đã thanh toán
2Đã hủy do hết thời gian chờ
3Đã hoàn tiền

product_type: Loại sản phẩm

Loại sản phẩmMô tả
3Nạp tiền vào tài khoản
9Gói lưu lượng truy cập động
11Gói lưu lượng theo giờ toàn cầu động V2
12Gói lưu lượng IDC dài hạn
13Gói lưu lượng IP tĩnh dân cư
14Gói IP tĩnh trung tâm dữ liệu
15Gói lưu lượng truy cập ISP dài hạn
16Gói Lưu Lượng Tĩnh
17Gói Số Lượng IP Động
18web-scraper
19Gia hạn IP tĩnh
20Quota Thay Thế IP Tĩnh
21Gói Lưu Lượng Tĩnh v2
24Gói Bổ Sung Lưu Lượng Tĩnh
25Gói IP Tĩnh Dân Dụng
26Hoàn tất đơn hàng - Một số kênh thanh toán yêu cầu người dùng nhập số tiền theo cách thủ công, chẳng hạn như: tiền ảo. Nếu có thiếu hụt, bạn cần liên hệ với bộ phận dịch vụ khách hàng để thanh toán bổ sung thông qua sản phẩm này
27Serp
28Video

Giá trị Enum

Thuộc tínhGiá trị
trạng thái0
trạng thái1
trạng thái2
trạng thái3
product_type3
product_type9
product_type11
product_type12
product_type14
product_type16
product_type17
product_type18
product_type19
product_type21
product_type24
product_type25
product_type26
product_type27
product_type28

Ví dụ trả về

Phản hồi 200

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

Mã trạng tháiÝ nghĩa mã trạng tháiMô tảMô hình dữ liệu
200OKThành côngNội tuyến

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

POST Tạo đơn hàng

POST /open/order/create

Do sự đa dạng của các gói và cấu hình khác nhau cho mỗi gói, vui lòng điền các tham số theo tình hình thực tế. Các tham số điền không đúng có thể khiến việc tạo đơn hàng không thành công.

Ví dụ:

Gia hạn IP tĩnh

{
    "pid": x, // 联系客服获取
    "upids": "1,2,3,4,5,6", // 从 /end-point/ip/get-static-ip 获取对应的ID
    "pm_id": 1 // 从 /end-point/payment/list 获取
    "coupon_sn: "xxx", // 可选 优惠券
  }

Tham số yêu cầu thân

{
	"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ênVị tríLoạiBắt buộcMô tả
bodybodyđối tượngĐúngkhông có
» pidbodysố nguyênĐúngID gói
» upidsbodychuỗiKhôngDanh sách ID gói gia hạn
» số lượngbodysốKhôngSố lượng gói mới
» pm_idbodysố nguyênCóID phương thức thanh toán
» region_listbodychuỗiKhôngVui lòng chỉ định khu vực + số lượng khi mua IP tĩnh
» coupon_snbodychuỗiKhôngMã giảm giá
» use_invitation_registration_discountbodybooleanKhôngCó sử dụng chiết khấu đăng ký lời mời hay không
» renew_durationbodysố nguyênKhôngThời hạn gia hạn - Tùy chọn IP tĩnh
» product_sku_bandwidth_idbodysố nguyênKhôngGói 11: ID Gói băng thông
» product_sku_concurrency_idbodysố nguyênKhôngGói 11: ID Gói đồng thời
» recharge_amountbodysố nguyênKhôngGói 3: Số tiền nạp

Ví dụ trả về

Phản hồi 200

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

Mã trạng tháiÝ nghĩa mã trạng tháiMô tảMô hình dữ liệu
200OKTạo thành côngNội tuyến

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

POST Hủy Đơn Hàng

POST /open/order/close

Tham số yêu cầu thân

{
	"trade_no": "string"
}

Tham số yêu cầu

TênVị tríLoạiBắt buộcMô tả
bodybodyđối tượngCókhông có
» trade_nobodychuỗiĐúngkhông có

Kết quả trả về

Mã trạng tháiÝ nghĩa mã trạng tháiMô tảMô hình dữ liệu
200OKThao tác thành côngKhông có

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

GET Lấy Thông Tin Người Dùng - Chưa Mở

GET /open/user/info

Ví dụ trả về

Phản hồi 200

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

Mã trạng tháiÝ nghĩa mã trạng tháiMô tảMô Hình Dữ Liệu
200OKThành côngNội tuyến

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

Quản lý thanh toán

GET Lấy danh sách phương thức thanh toán

GET /open/payment/groups

Tham số yêu cầu

TênVị tríLoạiBắt buộcMô tả
trade_notruy vấnchuỗiKhôngSố đơn hàng - có thể được chuyển vào khi một số đơn hàng cần lấy một phương thức thanh toán cụ thể

Ví dụ trả về

Phản hồi 200

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

Mã trạng tháiÝ nghĩa mã trạng tháiMô tảMô hình dữ liệu
200OKLấy thành côngNội tuyến

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

TênLoạiBắt buộcRàng buộcTên tiếng TrungMô tả
» codesố nguyênsaikhô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 tên thật
» tin nhắnchuỗisaikhông cóThông báo trạng thái
» datađối tượngsaikhông cókhông có
»» namechuỗisaikhông cóTên nhóm
»» logosstring[]saikhông cóDanh sách biểu tượng nhóm
»» itemsobject[]saikhông cóDanh sách các mục được nhóm
»»» idsố nguyênsaikhông cóID phương thức thanh toán
»»» titlechuỗisaikhông cóTên phương thức thanh toán
»»» logochuỗisaikhông cóLogo phương thức thanh toán
»»» groupchuỗisaikhông cóĐịnh danh nhóm phương thức thanh toán
»»» disabledbooleansaikhông cóCó tắt hay không (mặc định là false)
»» minsốsaikhông cóSố lượng tối thiểu
»»» tối đasốsaikhông cóSố lượng tối đa

Tiếp thị

NHẬN Tỷ Lệ Thưởng Nạp Tiền

GET /open/activity/balance-recharge-gift-ratio

Tỷ Lệ Thưởng Nạp Tiền

Ví dụ trả về

Phản hồi 200

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

Kết quả trả về

Mã trạng tháiÝ nghĩa mã trạng tháiMô tảMô Hình Dữ Liệu
200OKOKNội tuyến

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

TênLoạiBắt buộcRàng buộcTên tiếng TrungMô tả
» codesố nguyênsaikhô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 tên thật
» tin nhắnchuỗisaikhông cóTin nhắn trạng thái
» datađối tượngsaikhông cókhông có
» danh sách[đối tượng]saikhông cókhông có
»» số lượngsố nguyênsaikhông cóSố tiền nạp
»» tỷ lệsốsaikhông cóTỷ lệ nạp

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

productTypes (Loại gói)

TrườngLoạiMô tả
product_typesố nguyênLoại Gói

Mô tả các Giá trị Tùy chọn:

Giá trịÝ nghĩa
9Gói Lưu lượng Truy cập Khu dân cư Động
11IP dân cư động
14IP trung tâm dữ liệu tĩnh
25IP tĩnh dân cư

Khóa API

Được sử dụng để xác thực giao diện, vui lòng truyền nó qua tham số Query.

Tên tham sốVị tríLoạiBắt buộcMô tả
app_keytruy vấnchuỗiCóKhóa xác thực

Các Trường Phản Hồi Phổ Biến

responseCode

TrườngLoạiVí dụMô tả
codesố nguyên200Mã trạng thái (200 là thành công, 3 có nghĩa là app_key không hợp lệ)

responseMsg

TrườngLoạiVí dụMô tả
tin nhắnchuỗithành côngThô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": {}
}

Người dùng

{
	"id": 0,
	"email": "[email protected]",
	"phone": "string",
	"balance": 0.1,
	"status": 0,
	"is_real_name": true,
	"created_at": "2019-08-24T14:15:22Z"
}
TênLoạiBắt buộcRàng buộcTên tiếng TrungMô tả
idsố nguyênsaikhông cókhông có
emailchuỗi(email)saikhông cókhông có
điện thoạichuỗisaikhông cókhông có
số dưsố (số thực)saikhông cókhông có
trạng tháisố nguyênsaikhông cókhông có
is_real_namebooleansaikhông cókhông có
created_atstring(date-time)saikhông cókhông có

Thứ tự

{
	"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ênLoạiBắt buộcRàng buộcTên tiếng TrungMô tả
idsố nguyênsaikhông cókhông có
trade_nochuỗisaikhông cókhông có
product_idsố nguyênsaikhông cókhông có
product_namechuỗisaikhông cókhông có
total_feesố (số thực)saikhông cókhông có
pay_feesố (số thực)saikhông cókhông có
trạng tháisố nguyênsaikhông cókhông có
created_atstring(date-time)saikhông cókhông có

Sản phẩm

{
	"id": 0,
	"name": "string",
	"type": 0,
	"price": 0.1,
	"description": "string"
}
TênLoạiBắt buộcRàng buộcTên tiếng TrungMô tả
idsố nguyênsaikhông cókhông có
tênchuỗisaikhông cókhông có
loạisố nguyênsaikhông cókhông có
giásố (số thực)saikhông cókhông có
mô tảchuỗisaikhông cókhông có

WhiteIp

{
	"id": 0,
	"ip": "string",
	"remark": "string",
	"created_at": "2019-08-24T14:15:22Z"
}
TênLoạiBắt buộcRàng buộcTên tiếng TrungMô tả
idsố nguyênsaikhông cókhông có
địa chỉ IPchuỗisaikhông cókhông có
ghi chúchuỗisaikhông cókhông có
created_atstring(date-time)saikhông cókhông có

WhitelistAccount

{
	"id": 0,
	"username": "string",
	"limit": 0,
	"used": 0,
	"status": 0
}
TênLoạiBắt buộcRàng buộcTên tiếng TrungMô tả
idsố nguyênsaikhông cókhông có
Tên người dùngchuỗisaikhông cókhông có
giới hạnsố nguyênsaikhông cókhông có
đã sử dụngsố nguyênsaikhông cókhông có
trạng tháisố nguyênsaikhông cókhông có

Phiếu giảm giá

{
	"id": 0,
	"name": "string",
	"code": "string",
	"discount": 0.1,
	"expire_time": "2019-08-24T14:15:22Z"
}
TênLoạiBắt buộcRàng buộcTên tiếng TrungMô tả
idsố nguyênsaikhông cókhông có
tênchuỗisaikhông cókhông có
codechuỗisaikhông cókhông có
giảm giásố (số thực)saikhông cókhông có
thời_gian_hết_hạnstring(date-time)saikhông cókhông có

Bài viết

{
	"id": 0,
	"title": "string",
	"content": "string",
	"created_at": "2019-08-24T14:15:22Z"
}
TênLoạiBắt buộcRàng buộcTên tiếng TrungMô tả
idsố nguyênsaikhông cókhông có
titlechuỗisaikhông cókhông có
nội dungchuỗisaikhông cókhông có
created_atstring(date-time)saikhông cókhông có

Phân trang

{
	"total": 0,
	"page_no": 0,
	"page_size": 0,
	"total_pages": 0
}
TênLoạiBắt buộcRàng buộcTên tiếng TrungGiải thích
tổngsố nguyênsaikhông cókhông có
số_trangsố nguyênsaikhông cókhông có
Kích thước trangsố nguyênsaikhông cókhông có
tổng_số_trangsố nguyênsaikhông cókhông có