OpenAPIOpenAPI
  • English
  • 繁體中文
  • Indonesia
  • हिंदी
  • Русский
  • Tiếng Việt
  • German
  • português
  • English
  • 繁體中文
  • Indonesia
  • हिंदी
  • Русский
  • Tiếng Việt
  • German
  • português
  • 911Proxy OpenAPI

911Proxy OpenAPI

app_key 認證密鑰請登錄後在個人中心首頁查看。

請安全保存密鑰,密鑰擁有您的賬戶管理員權限。

認證方式

App Key 認證

POST 參數:

app_key: {your_app_key}

或作為查詢參數:

?app_key={your_app_key}

響應格式

所有接口返回統一的 JSON 格式:

{
	"code": 200,
	"message": "操作成功",
	"data": {}
}
  • code: 狀態碼,200 表示成功,其他值表示失敗
  • message: 響應消息(中文)
  • data: 響應數據

Base URLs:

  • https://api.911proxy.com

Authentication

  • HTTP Authentication, scheme: bearer
  • API Key (apiKeyAuth)
    • Parameter Name: app_key, in: query. 支持GET/POST,name 支持

代理賬戶管理

代理賬戶列表

Code samples

# You can also use wget
curl -X GET https://api.911proxy.com/api-gate-way/whitelist-account/list?app_key=pa%24%24word \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET /api-gate-way/whitelist-account/list

參數

名稱位置類型必填說明
app_keyquerystring(password)true認證密鑰

響應示例

200 Response

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

響應

狀態碼含義說明數據模型
200OK請求成功Inline

響應結構

Status Code 200

名稱類型必填約束說明
» coderesponseCodefalsenone狀態碼,200 成功、3 app_key 無效
» msgstringfalsenone狀態消息
» dataobjectfalsenonenone
»» list[object]falsenonenone
»»» idintegerfalsenone賬戶編號
»»» usernamestringfalsenone代理賬戶名
»»» passwordstringfalsenone代理賬戶密碼
»»» created_atstringfalsenone添加時間
»»» remarkstringfalsenone備註
»»» product_typeproductTypesfalsenone套餐類型,9 動態住宅流量套餐、11 動態住宅IP、14靜態數據中心IP、25 靜態住宅IP
»»» usage_flowintegerfalsenone已使用流量,單位:KB
»»» limit_flowintegerfalsenone自定義流量上限:單位GB最大102400,0 不限制
»»» statusintegerfalsenone啟用狀態:1啟用,0停用

Enumerated Values

屬性值
product_type9
product_type11
product_type14
product_type25
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

添加代理賬戶。

Code samples

# You can also use wget
curl -X POST https://api.911proxy.com/api-gate-way/whitelist-account/add \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST /api-gate-way/whitelist-account/add

Body parameter

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

參數

名稱位置類型必填說明
bodybodyobjectfalsenone
» app_keybodystringfalse授權密鑰
» accountsbodystringfalse賬戶密碼,請按格式 username:password 填寫,賬戶和密碼僅支持數字和字母,禁止輸入任何特殊符號或空格,冒號隔開賬戶和密碼。支持批量添加,英文逗號(,)分隔代理賬戶。
» remarkbodystringfalse代理賬戶描述
» product_typebodyproductTypesfalse套餐類型,9 動態住宅流量套餐、11 動態住宅IP、14靜態數據中心IP、25 靜態住宅IP

Enumerated Values

參數值
» product_type9
» product_type11
» product_type14
» product_type25

響應示例

200 Response

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

響應

狀態碼含義說明數據模型
200OK請求成功Inline

響應結構

Status Code 200

名稱類型必填約束說明
» codeintegerfalsenone狀態碼,200 成功、3 app_key 無效、156 賬戶未實名認證
» msgstringfalsenone狀態消息
» datanullfalsenonenone
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

刪除代理賬戶

Code samples

# You can also use wget
curl -X POST https://api.911proxy.com/api-gate-way/whitelist-account/delete \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST /api-gate-way/whitelist-account/delete

請注意刪除後無法恢復,已使用流量等無法查詢。刪除約有5分鐘等待時間,在此期間仍可能產生費用。

Body parameter

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

參數

名稱位置類型必填說明
bodybodyobjectfalsenone
» app_keybodystringfalse授權密鑰
» accountsbodystringfalse代理賬戶,僅支持數字和字母。支持批量操作,英文逗號(,)分隔代理賬戶

響應示例

200 Response

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

響應

狀態碼含義說明數據模型
200OK請求成Inline

響應結構

Status Code 200

名稱類型必填約束說明
» codeintegerfalsenone狀態碼,200 成功、3 app_key 無效、156 賬戶未實名認證
» msgstringfalsenone狀態消息
» datanullfalsenonenone
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

禁用代理賬戶

Code samples

# You can also use wget
curl -X POST https://api.911proxy.com/api-gate-way/whitelist-account/disable \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST /api-gate-way/whitelist-account/disable

禁用約有5分鐘等待時間,在此期間仍可能產生費用。

Body parameter

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

參數

名稱位置類型必填說明
bodybodyobjectfalsenone
» app_keybodystringfalse授權密鑰
» accountsbodystringfalse代理賬戶,僅支持數字和字母。支持批量操作,英文逗號(,)分隔代理賬戶

響應示例

200 Response

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

響應

狀態碼含義說明數據模型
200OK請求成Inline

響應結構

Status Code 200

名稱類型必填約束說明
» codeintegerfalsenone狀態碼,200 成功、3 app_key 無效、156 賬戶未實名認證
» msgstringfalsenone狀態消息
» datanullfalsenonenone
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

啟用代理賬戶

Code samples

# You can also use wget
curl -X POST https://api.911proxy.com/api-gate-way/whitelist-account/enable \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST /api-gate-way/whitelist-account/enable

Body parameter

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

參數

名稱位置類型必填說明
bodybodyobjectfalsenone
» app_keybodystringfalse授權密鑰
» accountsbodystringfalse代理賬戶,僅支持數字和字母。支持批量操作,英文逗號(,)分隔代理賬戶

響應示例

200 Response

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

響應

狀態碼含義說明數據模型
200OK請求成Inline

響應結構

Status Code 200

名稱類型必填約束說明
» codeintegerfalsenone狀態碼,200 成功、3 app_key 無效、156 賬戶未實名認證
» msgstringfalsenone狀態消息
» datanullfalsenonenone
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

修改代理賬戶密碼

Code samples

# You can also use wget
curl -X POST https://api.911proxy.com/api-gate-way/whitelist-account/change-password \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST /api-gate-way/whitelist-account/change-password

請注意修改後有5分鐘等待時間,在此期間舊密碼仍可能正常使用。

Body parameter

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

參數

名稱位置類型必填說明
bodybodyobjectfalsenone
» app_keybodystringfalse授權密鑰
» accountbodystringfalse代理賬戶,僅支持數字和字母。
» passwordbodystringfalse代理賬戶新密碼,僅支持數字和字母。

響應示例

200 Response

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

響應

狀態碼含義說明數據模型
200OK請求成Inline

響應結構

Status Code 200

名稱類型必填約束說明
» codeintegerfalsenone狀態碼,200 成功、3 app_key 無效、156 賬戶未實名認證
» msgstringfalsenone狀態消息
» datanullfalsenonenone
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

修改代理賬戶備註

Code samples

# You can also use wget
curl -X POST https://api.911proxy.com/api-gate-way/whitelist-account/change-remark \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST /api-gate-way/whitelist-account/change-remark

Body parameter

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

參數

名稱位置類型必填說明
bodybodyobjectfalsenone
» app_keybodystringfalse授權密鑰
» accountbodystringfalse代理賬戶,僅支持數字和字母。
» remarkbodystringfalse代理賬戶新備註,32箇中文或64個英文以內。

響應示例

200 Response

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

響應

狀態碼含義說明數據模型
200OK請求成Inline

響應結構

Status Code 200

名稱類型必填約束說明
» codeintegerfalsenone狀態碼,200 成功、3 app_key 無效、156 賬戶未實名認證
» msgstringfalsenone狀態消息
» datanullfalsenonenone
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

修改代理賬戶流量上限

Code samples

# You can also use wget
curl -X POST https://api.911proxy.com/api-gate-way/whitelist-account/change-limit \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST /api-gate-way/whitelist-account/change-limit

請注意流量統計可能有5分鐘以內延遲,即實際消耗流量可能超過此限制。

Body parameter

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

參數

名稱位置類型必填說明
bodybodyobjectfalsenone
» app_keybodystringfalse授權密鑰
» accountbodystringfalse代理賬戶,僅支持數字和字母。
» limitbodyintegerfalse流量限制,單位:GB,0為不設上限

響應示例

200 Response

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

響應

狀態碼含義說明數據模型
200OK請求成Inline

響應結構

Status Code 200

名稱類型必填約束說明
» codeintegerfalsenone狀態碼,200 成功、3 app_key 無效、156 賬戶未實名認證
» msgstringfalsenone狀態消息
» datanullfalsenonenone
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

修改代理賬戶信息

Code samples

# You can also use wget
curl -X POST https://api.911proxy.com/api-gate-way/proxy-account/change \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST /api-gate-way/proxy-account/change

修改代理賬戶密碼、備註、流量限制、每日流量限制、啟用狀態或 UDP 開關。

Body parameter

{
	"app_key": "string",
	"account": "string",
	"password": "string",
	"remark": "string",
	"limit": 0,
	"daily_limit": 0,
	"status": 0,
	"udp": 0
}

參數

名稱位置類型必填說明
bodybodyobjectfalsenone
» app_keybodystringfalse授權密鑰
» accountbodystringfalse代理賬戶名
» passwordbodystringfalse新密碼,6-16 位數字或字母;不傳則不修改
» remarkbodystringfalse新備註
» limitbodyintegerfalse流量上限,單位 GB,0 表示不限制
» daily_limitbodyintegerfalse每日流量上限,單位 GB,0 表示不限制
» statusbodyintegerfalse啟用狀態
» udpbodyintegerfalseUDP 支持開關,僅對套餐類型 14、16、21、25 生效

Enumerated Values

參數值
» status0
» status1
» udp0
» udp1

響應示例

200 Response

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

響應

狀態碼含義說明數據模型
200OK請求成功Inline

響應結構

Status Code 200

名稱類型必填約束說明
» codeintegerfalsenone狀態碼,200 成功
» msgstringfalsenone狀態消息
» datanullfalsenonenone
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

訂單管理

訂單創建、查詢、取消等

訂單列表

Code samples

# You can also use wget
curl -X GET https://api.911proxy.com/api-gate-way/order/list \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET /api-gate-way/order/list

參數

名稱位置類型必填說明
page_noqueryintegerfalsenone
page_sizequeryintegerfalsenone
trade_noquerystringfalse訂單編號
start_timequerystring(date-time)false開始時間(包含),如 2024-01-01 00:00:00
end_timequerystring(date-time)false結束時間(不包含)
statusqueryintegerfalse訂單狀態
product_typequeryintegerfalse產品類型
invoicequeryintegerfalse發票狀態:0不限制 1已開發票 -1未開發票(可補開)
pay_fee_statusqueryintegerfalse長短款篩選:1超額支付 2短款支付

Detailed descriptions

status: 訂單狀態

狀態描述
0待支付
1已支付
2超時未支付已取消
3已退款

product_type: 產品類型 | 產品類型 | 描述 | |---|---| |3|餘額充值| |9|動態流量套餐| |11|動態全球包時套餐V2| |12|長效IDC流量套餐| |13|住宅靜態IP流量套餐| |14|數據中心靜態IP套餐| |15|長效ISP流量套餐| |16|靜態流量套餐| |17|動態IP數量套餐| |18|web-scraper| |19|靜態IP續費| |20|靜態IP更換配額| |21|靜態流量套餐v2| |24|靜態流量附加包套餐| |25|住宅靜態IP套餐| |26|補單 - 部分支付渠道需要用戶手動填寫金額,如:虛擬幣,若發生短款,需要聯繫客服通過此種產品進行補支付| |27|Serp| |28|Video|

Enumerated Values

參數值
status0
status1
status2
status3
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
invoice-1
invoice0
invoice1
pay_fee_status1
pay_fee_status2

響應示例

200 Response

{
	"code": 0,
	"message": "操作成功",
	"data": {
		"list": [
			{
				"id": 0,
				"trade_no": "string",
				"out_trade_no": "string",
				"product_id": 0,
				"product_type": 0,
				"amount": 0,
				"unit_price": 0.1,
				"total_fee": 0.1,
				"goods_fee": 0.1,
				"pay_fee": 0.1,
				"discount_fee": 0.1,
				"handling_fee": 0.1,
				"refund_fee": 0.1,
				"pm_id": 0,
				"pm_title": "string",
				"pm_logo": "string",
				"status": 0,
				"title": "string",
				"detail": "string",
				"region_desc": "string",
				"pay_at": "2019-08-24T14:15:22Z",
				"pay_timestamp": 0,
				"created_at": "2019-08-24T14:15:22Z",
				"pay_fee_status": 0,
				"invoice": {
					"name": "string",
					"org_name": "string",
					"first_name": "string",
					"last_name": "string",
					"phone": "string",
					"email": "[email protected]",
					"role_type": 0,
					"vat_id": "string",
					"address_country": "string",
					"address_city": "string",
					"address_line1": "string",
					"address_line2": "string",
					"address_postal_code": "string"
				}
			}
		],
		"pagination": {
			"total": 0,
			"page_no": 0,
			"page_size": 0,
			"total_pages": 0
		}
	}
}

響應

狀態碼含義說明數據模型
200OK成功Inline

響應結構

To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

創建訂單

Code samples

# You can also use wget
curl -X POST https://api.911proxy.com/api-gate-way/order/create \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST /api-gate-way/order/create

因套餐種類較多,且每種套餐存在不同的配置,請根據實際情況填寫參數。不正當填寫參數可能導致訂單創建失敗。

examples:

續費靜態IP

{
    "pid": 套餐ID, // 從 /api-gate-way/product 接口獲取
    "upids": "1,2,3,4,5,6", // 從 /api-gate-way/ip/get-static-ip 接口獲取對應的 id 字段
    "pm_id": 1 // 從 /api-gate-way/payment/list 或 /api-gate-way/payment/groups 接口獲取
  }

靜態住宅IP購買

{
  "pid": 套餐ID, // 從 /api-gate-way/product 接口獲取
  "pm_id": 支付方式ID, // 從 /api-gate-way/payment/list 或 /api-gate-way/payment/groups 接口獲取
  "region_list": "JP,15,333|DE,10,444|US,5,555" // 格式:地區,數量,ASN|地區,數量,ASN(ASN編號可選)
}

靜態數據中心IP購買

{
  "pid": 套餐ID, // 從 /api-gate-way/product 接口獲取
  "pm_id": 支付方式ID, // 從 /api-gate-way/payment/list 或 /api-gate-way/payment/groups 接口獲取
  "region_list": "JP,15,333|DE,10,444|US,5,555" // 格式:地區,數量,ASN|地區,數量,ASN(ASN編號可選)
}

動態住宅流量購買

{
  "pid": 套餐ID, // 從 /api-gate-way/product 接口獲取
  "pm_id": 支付方式ID // 從 /api-gate-way/payment/list 或 /api-gate-way/payment/groups 接口獲取
}

靜態輪換流量購買

{
  "pid": 套餐ID, // 從 /api-gate-way/product 接口獲取
  "pm_id": 支付方式ID // 從 /api-gate-way/payment/list 或 /api-gate-way/payment/groups 接口獲取
}

動態無限流量購買

{
  "pid": 套餐ID, // 從 /api-gate-way/product 接口獲取
  "pm_id": 支付方式ID, // 從 /api-gate-way/payment/list 或 /api-gate-way/payment/groups 接口獲取
  "product_sku_bandwidth_id": 帶寬規格ID,
  "product_sku_concurrency_id": 併發規格ID
}

餘額充值

{
  "pid": 套餐ID, // 從 /api-gate-way/product 接口獲取
  "pm_id": 支付方式ID, // 從 /api-gate-way/payment/list 或 /api-gate-way/payment/groups 接口獲取
  "recharge_amount": 充值金額
}

Body parameter

{
	"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,
	"product_sku_duration_id": 0,
	"etd": 1,
	"recharge_amount": 0
}

參數

| 名稱 | 位置 | 類型 | 必填 | 說明 | | --- | --- | --- | --- | --- | --- | --- | --- | | body | body | object | true | none | | » pid | body | integer | true | 套餐ID,來自 /api-gate-way/product 接口返回的 id 字段 | | » upids | body | string | false | 續費套餐ID列表(逗號分隔),來自 /api-gate-way/user-product/list 或 /api-gate-way/ip/get-static-ip 接口返回的 id 字段 | | » amount | body | number | false | 新購套餐數量 | | » pm_id | body | integer | true | 支付方式ID,來自 /api-gate-way/payment/list 或 /api-gate-way/payment/groups 接口返回的 id 字段 | | » region_list | body | string | false | 購買靜態IP時指定區域+數量+ASN編號,格式:地區,數量,ASN | 地區,數量,ASN,例如:JP,15,333 | DE,10,444 | US,5,555(ASN編號可選) | | » coupon_sn | body | string | false | 優惠券編號 | | » use_invitation_registration_discount | body | boolean | false | 是否使用邀請註冊優惠 | | » renew_duration | body | integer | false | 續費時長-靜態IP可選 | | » product_sku_bandwidth_id | body | integer | false | 套餐11:帶寬套餐ID | | » product_sku_concurrency_id | body | integer | false | 套餐11:併發套餐ID | | » product_sku_duration_id | body | integer | false | 套餐type=11必填:時長規格ID | | » etd | body | integer | false | 時長倍數,從套餐 extension_of_time_days 獲取,2代表天數×2,價格上浮 | | » recharge_amount | body | integer | false | 套餐3:充值金額 |

響應示例

200 Response

{
	"code": 0,
	"message": "操作成功",
	"data": {
		"id": 0,
		"trade_no": "string",
		"out_trade_no": "string",
		"product_id": 0,
		"product_type": 0,
		"amount": 0,
		"unit_price": 0.1,
		"total_fee": 0.1,
		"goods_fee": 0.1,
		"pay_fee": 0.1,
		"discount_fee": 0.1,
		"handling_fee": 0.1,
		"refund_fee": 0.1,
		"pm_id": 0,
		"pm_title": "string",
		"pm_logo": "string",
		"status": 0,
		"title": "string",
		"detail": "string",
		"region_desc": "string",
		"pay_at": "2019-08-24T14:15:22Z",
		"pay_timestamp": 0,
		"created_at": "2019-08-24T14:15:22Z",
		"pay_fee_status": 0,
		"invoice": {
			"name": "string",
			"org_name": "string",
			"first_name": "string",
			"last_name": "string",
			"phone": "string",
			"email": "[email protected]",
			"role_type": 0,
			"vat_id": "string",
			"address_country": "string",
			"address_city": "string",
			"address_line1": "string",
			"address_line2": "string",
			"address_postal_code": "string"
		}
	}
}

響應

狀態碼含義說明數據模型
200OK創建成功Inline

響應結構

To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

取消訂單

Code samples

# You can also use wget
curl -X POST https://api.911proxy.com/api-gate-way/order/close \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST /api-gate-way/order/close

Body parameter

{
	"trade_no": "string"
}

參數

名稱位置類型必填說明
bodybodyobjecttruenone
» trade_nobodystringtruenone

響應示例

200 Response

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

響應

狀態碼含義說明數據模型
200OK操作成功SuccessResponse
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

訂單預檢

Code samples

# You can also use wget
curl -X POST https://api.911proxy.com/api-gate-way/order/check \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST /api-gate-way/order/check

創建訂單前調用,用於預覽價格、折扣、IP續費明細等,不會實際創建訂單。參數與 /api-gate-way/order/create 完全一致。

Body parameter

{
	"pid": 0,
	"upids": "string",
	"amount": 1,
	"pm_id": 0,
	"region_list": "string",
	"coupon_sn": "string",
	"renew_duration": "1m",
	"product_sku_bandwidth_id": 0,
	"product_sku_concurrency_id": 0,
	"product_sku_duration_id": 0,
	"etd": 1,
	"recharge_amount": 0
}

參數

| 名稱 | 位置 | 類型 | 必填 | 說明 | | ---------------------------- | ---- | ------- | ----- | --------------------------------------------- | ----------- | | body | body | object | true | none | | » pid | body | integer | true | 套餐ID | | » upids | body | string | false | IP續費:用戶套餐ID列表,逗號分隔 | | » amount | body | integer | false | 購買數量 | | » pm_id | body | integer | true | 支付方式ID | | » region_list | body | string | false | 靜態IP購買地區+數量,格式:地區ID,數量 | 地區ID,數量 | | » coupon_sn | body | string | false | 優惠券編號 | | » renew_duration | body | string | false | IP續費時長:1m=1個月,2m=2個月,em=下個月月底 | | » product_sku_bandwidth_id | body | integer | false | 套餐type=11必填:帶寬規格ID | | » product_sku_concurrency_id | body | integer | false | 套餐type=11必填:併發規格ID | | » product_sku_duration_id | body | integer | false | 套餐type=11必填:時長規格ID | | » etd | body | integer | false | 時長倍數,從套餐 extension_of_time_days 獲取 | | » recharge_amount | body | number | false | 套餐type=3必填:充值金額 |

Enumerated Values

參數值
» renew_duration1m
» renew_duration2m
» renew_durationem

響應示例

200 Response

{
	"code": 0,
	"message": "操作成功",
	"data": {
		"product_id": 0,
		"amount": 0,
		"discount_fee": 0.1,
		"total_fee": 0.1,
		"pay_fee": 0.1,
		"product_type": 0,
		"title": "string",
		"detail": "string",
		"ip_result": [
			{
				"ip": "string",
				"price": 0.1,
				"country_code": "string",
				"current_time": "2019-08-24T14:15:22Z",
				"renewal_time": "2019-08-24T14:15:22Z",
				"country": {
					"name_zh_cn": "string",
					"flag": "string",
					"square_flag": "string"
				}
			}
		]
	}
}

響應

狀態碼含義說明數據模型
200OK預檢成功Inline

響應結構

To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

IP白名單

IP 白名單列表

Code samples

# You can also use wget
curl -X GET https://api.911proxy.com/api-gate-way/proxy-ip/list?app_key=pa%24%24word \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET /api-gate-way/proxy-ip/list

參數

名稱位置類型必填說明
app_keyquerystring(password)true認證密鑰
product_typequeryintegerfalse套餐類型編號

響應示例

200 Response

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			{
				"ip": "1.1.1.1",
				"remark": "string",
				"product_type": 0,
				"created_at": "string"
			}
		]
	}
}

響應

狀態碼含義說明數據模型
200OK請求成功Inline

響應結構

Status Code 200

名稱類型必填約束說明
» codeintegerfalsenone狀態碼,200 成功
» msgstringfalsenone狀態消息
» dataobjectfalsenonenone
»» list[object]falsenonenone
»»» ipstringfalsenone白名單 IP
»»» remarkstringfalsenone備註
»»» product_typeintegerfalsenone套餐類型
»»» created_atstringfalsenone創建時間
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

添加 IP 白名單

Code samples

# You can also use wget
curl -X POST https://api.911proxy.com/api-gate-way/proxy-ip/add \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST /api-gate-way/proxy-ip/add

Body parameter

{
	"app_key": "string",
	"ips": "1.1.1.1,2.2.2.2",
	"remark": "string",
	"product_type": 0,
	"user_product_id": 0
}

參數

名稱位置類型必填說明
bodybodyobjectfalsenone
» app_keybodystringfalse授權密鑰
» ipsbodystringfalse需要添加的白名單 IP,多個用英文逗號或換行分隔
» remarkbodystringfalse備註
» product_typebodyintegerfalse套餐類型編號
» user_product_idbodyintegerfalse用戶套餐 ID,套餐類型為 11 時必填

響應示例

200 Response

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

響應

狀態碼含義說明數據模型
200OK請求成功Inline

響應結構

Status Code 200

名稱類型必填約束說明
» codeintegerfalsenone狀態碼,200 成功
» msgstringfalsenone狀態消息
» datanullfalsenonenone
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

刪除 IP 白名單

Code samples

# You can also use wget
curl -X POST https://api.911proxy.com/api-gate-way/proxy-ip/delete \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST /api-gate-way/proxy-ip/delete

Body parameter

{
	"app_key": "string",
	"ips": "1.1.1.1,2.2.2.2",
	"verify_type": "string",
	"verify_code": "string"
}

參數

名稱位置類型必填說明
bodybodyobjectfalsenone
» app_keybodystringfalse授權密鑰
» ipsbodystringfalse需要刪除的白名單 IP,多個用英文逗號分隔
» verify_typebodystringfalse驗證類型:phone、email、wechat、totp
» verify_codebodystringfalse驗證碼

響應示例

200 Response

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

響應

狀態碼含義說明數據模型
200OK請求成功Inline

響應結構

Status Code 200

名稱類型必填約束說明
» codeintegerfalsenone狀態碼,200 成功
» msgstringfalsenone狀態消息
» datanullfalsenonenone
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

流量日誌查詢

使用流量按天彙總

Code samples

# You can also use wget
curl -X GET https://api.911proxy.com/api-gate-way/user-usage-flow/total?app_key=pa%24%24word \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET /api-gate-way/user-usage-flow/total

參數

名稱位置類型必填說明
app_keyquerystring(password)true認證密鑰
start_timequerystring(Y-m-d H:i:s)false起始時間,可精確到秒。請注意,日誌記錄有5分鐘以內延遲。默認7天以內。
end_timequerystring(Y-m-d H:i:s)false截止時間,可精確到秒。請注意,日誌記錄有5分鐘以內延遲。默認當前時間。
usernamequerystringfalse子賬戶名稱,默認查詢所有賬戶,可指定子賬戶。請注意如果您添加了相同名稱的子賬戶,此查詢將返回同名代理賬戶的所有使用記錄。
product_typequerynumberfalse套餐類型

響應示例

200 Response

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

響應

狀態碼含義說明數據模型
200OK請求成Inline

響應結構

Status Code 200

名稱類型必填約束說明
» codeintegerfalsenone狀態碼,200 成功、3 app_key 無效、156 賬戶未實名認證
» msgstringfalsenone狀態消息
» dataobjectfalsenonenone
»» list[object]falsenonenone
»»» daystringfalsenone日期
»»» flowintegerfalsenone消耗流量,單位KB
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

套餐查詢

已購套餐列表

Code samples

# You can also use wget
curl -X GET https://api.911proxy.com/api-gate-way/user-product/list?app_key=pa%24%24word \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET /api-gate-way/user-product/list

參數

名稱位置類型必填說明
app_keyquerystring(password)true認證密鑰
trade_noquerystringfalse訂單號,請輸入完整訂單號。不支持模糊搜索。
pagequerynumberfalse分頁,默認:1
sizequerynumberfalse分頁顯示數量,默認:20
product_typequerynumberfalse套餐類型

響應示例

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

響應

狀態碼含義說明數據模型
200OK請求成Inline

響應結構

Status Code 200

名稱類型必填約束說明
» codeintegerfalsenone狀態碼,200 成功、3 app_key 無效、156 賬戶未實名認證
» msgstringfalsenone狀態消息
» dataobjectfalsenonenone
»» list[object]falsenonenone
»»» idintegerfalsenone套餐編號
»»» created_atstringfalsenone套餐生效時間
»»» expired_atstringfalsenone套餐過期時間,過期後流量無法使用。
»»» product_typeproductTypesfalsenone套餐類型,9 動態住宅流量套餐、11 動態住宅IP、14靜態數據中心IP、25 靜態住宅IP
»»» trade_nostringfalsenone訂單交易號
»»» orderobjectfalsenonenone
»»»» created_atstringfalsenone訂單創建時間
»»»» pay_atstringfalsenone訂單支付時間
»»»» titlestringfalsenone訂單描述
»» pageintegerfalsenone當前分頁
»» page_sizeintegerfalsenone分頁大小
»» total_countintegerfalsenone總記錄數量
»» total_pageintegerfalsenone總分頁數量

Enumerated Values

屬性值
product_type9
product_type11
product_type14
product_type25
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

用戶套餐數據彙總

Code samples

# You can also use wget
curl -X GET https://api.911proxy.com/api-gate-way/user-product/summary?app_key=pa%24%24word \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET /api-gate-way/user-product/summary

獲取用戶套餐的統計彙總信息,包括總量、有效量、臨期量、過期量等

參數

名稱位置類型必填說明
app_keyquerystring(password)true認證密鑰
product_typequeryintegerfalse產品類型,僅支持 9(動態流量套餐)、12(長效IDC流量套餐)

Enumerated Values

參數值
product_type9
product_type12

響應示例

200 Response

{
	"code": 200,
	"msg": "成功",
	"data": {
		"total": 1048576,
		"total_count": 5,
		"effective": 524288,
		"effective_count": 3,
		"effective_total": 786432,
		"effective_used": 262144,
		"temporary": 102400,
		"temporary_count": 1,
		"expired": 51200,
		"expired_count": 1,
		"used": 473088
	}
}

響應

狀態碼含義說明數據模型
200OK請求成功Inline

響應結構

Status Code 200

名稱類型必填約束說明
» codeintegerfalsenone狀態碼,200 成功、3 app_key 無效、156 賬戶未實名認證
» msgstringfalsenone狀態消息
» dataobjectfalsenonenone
»» totalintegerfalsenone流量/IP總量(單位:KB)
»» total_countintegerfalsenone套餐總個數
»» effectiveintegerfalsenone有效剩餘量(單位:KB)
»» effective_countintegerfalsenone有效套餐個數
»» effective_totalintegerfalsenone有效總量(單位:KB)
»» effective_usedintegerfalsenone有效已使用量(單位:KB)
»» temporaryintegerfalsenone臨期總量(7天內到期,單位:KB)
»» temporary_countintegerfalsenone臨期套餐個數(7天內到期)
»» expiredintegerfalsenone過期剩餘量(單位:KB)
»» expired_countintegerfalsenone過期套餐個數
»» usedintegerfalsenone已使用總量(單位:KB)
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

IP提取

提取IP

Code samples

# You can also use wget
curl -X GET https://api.911proxy.com/api-gate-way/ip/v3?app_key=pa%24%24word \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET /api-gate-way/ip/v3

參數

名稱位置類型必填說明
app_keyquerystring(password)true訪問密鑰
ccquerystringfalse國家或地區
statequerystringfalse省或州
cityquerystringfalse城市
formatquerystringfalse獲取格式
lbquerystringfalse間隔符,僅text格式有效
numquerynumberfalse提取數量
lifequerynumberfalse保持週期-分鐘
epquerystringfalse代理網絡

Enumerated Values

參數值
epus
ephk
epde

響應示例

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

響應

狀態碼含義說明數據模型
200OK請求成Inline

響應結構

Status Code 200

名稱類型必填約束說明
» codeintegerfalsenone狀態碼,200 成功、3 app_key 無效、156 賬戶未實名認證
» msgstringfalsenone狀態消息
» dataobjectfalsenonenone
»» list[any]falsenonenone
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

動態地區城市列表V4

Code samples

# You can also use wget
curl -X GET https://api.911proxy.com/api-gate-way/ip/dcl4?username=string \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET /api-gate-way/ip/dcl4

按用戶名獲取城市列表,需要登錄認證,且賬戶必須屬於當前用戶

參數

名稱位置類型必填說明
usernamequerystringtrue代理賬戶用戶名

響應示例

200 Response

{
	"code": 200,
	"msg": "string",
	"data": {
		"cache": true,
		"list": [
			{
				"City": "Los Angeles",
				"Area": "US",
				"State": "California"
			}
		]
	}
}

響應

狀態碼含義說明數據模型
200OK請求成功Inline

響應結構

Status Code 200

名稱類型必填約束說明
» codeintegerfalsenone狀態碼,200 成功
» msgstringfalsenone狀態消息
» dataobjectfalsenonenone
»» cachebooleanfalsenone是否來自緩存
»» list[object]falsenonenone
»»» Citystringfalsenone城市
»»» Areastringfalsenone地區
»»» Statestringfalsenone州/省
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth, apiKeyAuth

動態地區州/省列表V4

Code samples

# You can also use wget
curl -X GET https://api.911proxy.com/api-gate-way/ip/dsl4?username=string \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET /api-gate-way/ip/dsl4

按用戶名獲取州/省列表,需要登錄認證,且賬戶必須屬於當前用戶

參數

名稱位置類型必填說明
usernamequerystringtrue代理賬戶用戶名

響應示例

200 Response

{
	"code": 200,
	"msg": "string",
	"data": {
		"cache": true,
		"list": [
			{
				"City": "Los Angeles",
				"Area": "US",
				"State": "California"
			}
		]
	}
}

響應

狀態碼含義說明數據模型
200OK請求成功Inline

響應結構

Status Code 200

名稱類型必填約束說明
» codeintegerfalsenone狀態碼,200 成功
» msgstringfalsenone狀態消息
» dataobjectfalsenonenone
»» cachebooleanfalsenone是否來自緩存
»» list[object]falsenonenone
»»» Citystringfalsenone城市
»»» Areastringfalsenone地區
»»» Statestringfalsenone州/省
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth, apiKeyAuth

動態地區州/省城市融合列表V4

Code samples

# You can also use wget
curl -X GET https://api.911proxy.com/api-gate-way/ip/dal4?username=string \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET /api-gate-way/ip/dal4

按用戶名獲取州/省和城市的融合列表,按地區分組。需要登錄認證,且賬戶必須屬於當前用戶

參數

名稱位置類型必填說明
usernamequerystringtrue代理賬戶用戶名

響應示例

200 Response

{
	"code": 200,
	"msg": "string",
	"data": {
		"cache": true,
		"list": [
			{
				"Area": "US",
				"states": [
					{
						"State": "California",
						"cities": ["Los Angeles"]
					}
				]
			}
		]
	}
}

響應

狀態碼含義說明數據模型
200OK請求成功Inline

響應結構

Status Code 200

名稱類型必填約束說明
» codeintegerfalsenone狀態碼,200 成功
» msgstringfalsenone狀態消息
» dataobjectfalsenonenone
»» cachebooleanfalsenone是否來自緩存
»» list[object]falsenone地區列表
»»» Areastringfalsenone地區代碼
»»» states[object]falsenone州/省列表
»»»» Statestringfalsenone州/省名稱
»»»» cities[string]falsenone城市列表
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth, apiKeyAuth

城市列表

Code samples

# You can also use wget
curl -X GET https://api.911proxy.com/api-gate-way/ip/dynamic-citys \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET /api-gate-way/ip/dynamic-citys

響應示例

200 Response

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

響應

狀態碼含義說明數據模型
200OK請求成Inline

響應結構

Status Code 200

名稱類型必填約束說明
» codeintegerfalsenone狀態碼,200 成功、3 app_key 無效、156 賬戶未實名認證
» msgstringfalsenone狀態消息
» dataobjectfalsenonenone
»» list[object]falsenone列表
»»» name_zh_cnstringfalsenone國家或地區名稱
»»» name_enstringfalsenone國家或地區名稱
»»» continent_codestringfalsenone大洲代碼
»»» country_codestringfalsenone國家或地區代碼
»»» items[any]falsenone省或州
»»»» citystringfalsenone城市名稱
»»»» statestringfalsenone省或州名稱代碼
»»»» continent_codestringfalsenone大洲代碼
»»»» country_codestringfalsenone國家或地區代碼
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

城市搜索

Code samples

# You can also use wget
curl -X GET https://api.911proxy.com/api-gate-way/ip/dynamic-citys/search?country_code=string&state=string \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET /api-gate-way/ip/dynamic-citys/search

參數

名稱位置類型必填說明
country_codequerystringtrue國家或地區代碼
statequerystringtrue州或省代碼

響應示例

200 Response

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

響應

狀態碼含義說明數據模型
200OK請求成Inline

響應結構

Status Code 200

名稱類型必填約束說明
» codeintegerfalsenone狀態碼,200 成功、3 app_key 無效、156 賬戶未實名認證
» msgstringfalsenone狀態消息
» dataobjectfalsenonenone
»» list[string]falsenone列表
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

州列表

Code samples

# You can also use wget
curl -X GET https://api.911proxy.com/api-gate-way/ip/dynamic-states \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET /api-gate-way/ip/dynamic-states

響應示例

200 Response

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

響應

狀態碼含義說明數據模型
200OK請求成Inline

響應結構

Status Code 200

名稱類型必填約束說明
» codeintegerfalsenone狀態碼,200 成功、3 app_key 無效、156 賬戶未實名認證
» msgstringfalsenone狀態消息
» dataobjectfalsenonenone
»» list[object]falsenone列表
»»» name_zh_cnstringfalsenone國家或地區名稱
»»» name_enstringfalsenone國家或地區名稱
»»» continent_codestringfalsenone大洲代碼
»»» country_codestringfalsenone國家或地區代碼
»»» items[any]falsenone省或州
»»»» statestringfalsenone省或州名稱代碼
»»»» continent_codestringfalsenone大洲代碼
»»»» country_codestringfalsenone國家或地區代碼
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

州/省搜索

Code samples

# You can also use wget
curl -X GET https://api.911proxy.com/api-gate-way/ip/dynamic-states/search?country_code=string \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET /api-gate-way/ip/dynamic-states/search

參數

名稱位置類型必填說明
country_codequerystringtrue國家或地區代碼

響應示例

200 Response

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

響應

狀態碼含義說明數據模型
200OK請求成Inline

響應結構

Status Code 200

名稱類型必填約束說明
» codeintegerfalsenone狀態碼,200 成功、3 app_key 無效、156 賬戶未實名認證
» msgstringfalsenone狀態消息
» dataobjectfalsenonenone
»» list[string]falsenone列表
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

提取已購買靜態IP列表

Code samples

# You can also use wget
curl -X GET https://api.911proxy.com/api-gate-way/ip/get-static-ip \
  -H 'Authorization: Bearer {access-token}'

GET /api-gate-way/ip/get-static-ip

參數

名稱位置類型必填說明
country_codequerystringfalse國家或地區代碼
product_typequerynumberfalse產品類型, 25:靜態住宅IP, 14: 數據中心IP
trade_noquerystringfalse通過訂單號篩選IP
pagequerynumberfalse頁碼
sizequerynumberfalse每頁數量
statusquerynumberfalse狀態, 1:有效, 2:無效, 3:即將過期, 4:維護中

Enumerated Values

參數值
product_type14
product_type25
status1 - 2 - 3 - 4

響應

狀態碼含義說明數據模型
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

獲取在售地區靜態IP數量

Code samples

# You can also use wget
curl -X GET https://api.911proxy.com/api-gate-way/ip/static-ip-region \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET /api-gate-way/ip/static-ip-region

參數

名稱位置類型必填說明
ispqueryintegerfalseISP 篩選,不傳則不篩選(站點 1/4/5 除外默認為 1)
asnqueryintegerfalse是否返回 ASN 分組數據
exclusivequeryintegerfalse是否按獨享庫存統計

Detailed descriptions

isp: ISP 篩選,不傳則不篩選(站點 1/4/5 除外默認為 1)

值描述
0數據中心靜態IP(IDC)
1家庭住宅靜態IP(ISP)

asn: 是否返回 ASN 分組數據

值描述
0不返回 ASN 分組數據(默認)
1返回 ASN 分組數據

exclusive: 是否按獨享庫存統計

值描述
0按當前用戶/共享組口徑統計(默認)
1排除所有已分配IP,僅統計可用庫存

Enumerated Values

參數值
isp0
isp1
asn0
asn1
exclusive0
exclusive1

響應示例

200 Response

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

響應

狀態碼含義說明數據模型
200OK請求成功Inline

響應結構

Status Code 200

名稱類型必填約束說明
» codeintegerfalsenone狀態碼,200 成功
» msgstringfalsenone狀態消息
» dataobjectfalsenonenone
»» list[any]falsenonenone
»»» codestringfalsenone國家或地區代碼
»»» numberintegerfalsenone數量
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

獲取 host_pool 支持國家/地區

Code samples

# You can also use wget
curl -X GET https://api.911proxy.com/api-gate-way/host-pool/regions \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET /api-gate-way/host-pool/regions

查詢 host_pool 服務當前站點支持的國家/地區列表。

該接口面向數據中心 IP 按流量積分的隨機提取場景,僅按當前站點可用數據中心 IP 庫存統計國家/地區。不支持 ASN、ISP、獨享庫存篩選,也不會按用戶已購買記錄排除 IP。

響應示例

200 Response

{
	"code": 200,
	"msg": "請求成功",
	"data": {
		"list": [
			{
				"code": "US",
				"number": 55,
				"name_zh_cn": "美國",
				"name_en": "United States",
				"square_flag": "https://example.com/static/flags/us.png"
			}
		]
	}
}

響應

狀態碼含義說明數據模型
200OK請求成功Inline

響應結構

Status Code 200

名稱類型必填約束說明
» codeintegerfalsenone狀態碼,200 成功
» msgstringfalsenone狀態消息
» dataobjectfalsenonenone
»» list[object]falsenonenone
»»» codestringfalsenone國家或地區代碼,ISO 3166-1 alpha-2
»»» numberintegerfalsenone當前站點可用數據中心 IP 數量
»»» name_zh_cnstringfalsenone國家或地區中文名稱
»»» name_enstringfalsenone國家或地區英文名稱
»»» square_flagstringfalsenone方形國旗圖片 URL
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

支付管理

獲取支付方式列表

Code samples

# You can also use wget
curl -X GET https://api.911proxy.com/api-gate-way/payment/groups \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET /api-gate-way/payment/groups

參數

名稱位置類型必填說明
trade_noqueryundefinedfalse訂單號 - 部分訂單需要獲取特定支付方式時可傳入

響應示例

200 Response

{
	"code": 0,
	"message": "操作成功",
	"data": {
		"list": [
			{
				"name": "string",
				"logos": ["string"],
				"items": [
					{
						"id": 0,
						"title": "string",
						"logo": "string",
						"group": "string",
						"disabled": false,
						"min": 0,
						"max": 0
					}
				]
			}
		]
	}
}

響應

狀態碼含義說明數據模型
200OK獲取成功Inline

響應結構

To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

營銷

充值贈金比例

Code samples

# You can also use wget
curl -X GET https://api.911proxy.com/api-gate-way/activity/balance-recharge-gift-ratio \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET /api-gate-way/activity/balance-recharge-gift-ratio

充值贈金比例

響應示例

200 Response

{
	"code": 0,
	"message": "操作成功",
	"data": {
		"list": [null]
	}
}

響應

狀態碼含義說明數據模型
200OKOKInline

響應結構

To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

產品

產品列表

Code samples

# You can also use wget
curl -X GET https://api.911proxy.com/api-gate-way/product \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

GET /api-gate-way/product

獲取當前站點可購買的套餐列表,支持按類型、有效期等條件篩選。

參數

名稱位置類型必填說明
typequeryintegerfalse套餐類型,見 Product.type 枚舉說明。不傳則返回所有類型。
parent_product_typequeryintegerfalse父套餐類型,僅 type=19(IP續費)時有效,用於篩選產品線:14=數據中心 25=住宅
time_daysqueryanyfalse有效期天數篩選,支持單值或數組,如 30 / [30,90,365]
show_typequeryanyfalse展示類型篩選,支持單值或數組

Detailed descriptions

type: 套餐類型,見 Product.type 枚舉說明。不傳則返回所有類型。

Enumerated Values

參數值
parent_product_type14
parent_product_type25

響應示例

200 Response

{
	"code": 0,
	"message": "操作成功",
	"data": [
		{
			"id": 0,
			"title": "string",
			"type": 0,
			"show_type": 0,
			"status": 0,
			"price": 0.1,
			"usd_price": 0.1,
			"price_hkd": 0.1,
			"original_price": 0.1,
			"original_usd_price": 0.1,
			"original_price_hkd": 0.1,
			"local_price": 0.1,
			"local_original_price": 0.1,
			"preferred_currency": "string",
			"support_currencies": "string",
			"flow_value": 0.1,
			"flow_give": 0.1,
			"balance_give": 0.1,
			"balance_value": 0.1,
			"time_validity": 0.1,
			"time_price": 0.1,
			"time_days": 0,
			"tip1": "string",
			"tip2": "string",
			"introduce": ["string"],
			"region_list_id": 0,
			"renew_product_list": "string",
			"parent_product_type": 0,
			"total_count": 0,
			"remain_count": 0,
			"extension_of_time_days": [0],
			"time_days_price_rate": 0.1,
			"desc": {
				"subtitle": "string",
				"flow_value": 0.1,
				"flow_give": 0.1,
				"balance_give": 0.1,
				"time_validity": 0.1,
				"time_price": 0.1,
				"tip1": "string",
				"tip2": "string",
				"introduce": ["string"]
			},
			"sku": {
				"bandwidth_list": [
					{
						"id": 0,
						"value": 0,
						"price": 0.1,
						"price_usd": 0.1,
						"price_hkd": 0.1
					}
				],
				"duration_list": [
					{
						"id": 0,
						"value": 0,
						"price": 0.1,
						"price_usd": 0.1,
						"price_hkd": 0.1
					}
				],
				"concurrency_list": [
					{
						"id": 0,
						"value": 0,
						"price": 0.1,
						"price_usd": 0.1,
						"price_hkd": 0.1
					}
				]
			}
		}
	]
}

響應

狀態碼含義說明數據模型
200OKOKInline

響應結構

To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

Schemas

productTypes

9

套餐類型,9 動態住宅流量套餐、11 動態住宅IP、14靜態數據中心IP、25 靜態住宅IP

Properties

名稱類型必填約束說明
anonymousintegerfalsenone套餐類型,9 動態住宅流量套餐、11 動態住宅IP、14靜態數據中心IP、25 靜態住宅IP

Enumerated Values

屬性值
anonymous9
anonymous11
anonymous14
anonymous25

apiKey

{}

認證密鑰

Properties

None

responseCode

200

狀態碼,200 成功、3 app_key 無效

Properties

名稱類型必填約束說明
anonymousintegerfalsenone狀態碼,200 成功、3 app_key 無效

responseMsg

"success"

response message

Properties

名稱類型必填約束說明
anonymousstringfalsenoneresponse message

SuccessResponse

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

Properties

名稱類型必填約束說明
codeintegerfalsenonenone
messagestringfalsenonenone
dataobjectfalsenonenone

ErrorResponse

{
	"code": 400,
	"message": "參數錯誤",
	"errors": {}
}

Properties

名稱類型必填約束說明
codeintegerfalsenonenone
messagestringfalsenonenone
errorsobjectfalsenonenone

User

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

Properties

名稱類型必填約束說明
idintegerfalsenonenone
emailstring(email)falsenonenone
phonestringfalsenonenone
balancenumber(float)falsenonenone
statusintegerfalsenonenone
is_real_namebooleanfalsenonenone
created_atstring(date-time)falsenonenone

Order

{
	"id": 0,
	"trade_no": "string",
	"out_trade_no": "string",
	"product_id": 0,
	"product_type": 0,
	"amount": 0,
	"unit_price": 0.1,
	"total_fee": 0.1,
	"goods_fee": 0.1,
	"pay_fee": 0.1,
	"discount_fee": 0.1,
	"handling_fee": 0.1,
	"refund_fee": 0.1,
	"pm_id": 0,
	"pm_title": "string",
	"pm_logo": "string",
	"status": 0,
	"title": "string",
	"detail": "string",
	"region_desc": "string",
	"pay_at": "2019-08-24T14:15:22Z",
	"pay_timestamp": 0,
	"created_at": "2019-08-24T14:15:22Z",
	"pay_fee_status": 0,
	"invoice": {
		"name": "string",
		"org_name": "string",
		"first_name": "string",
		"last_name": "string",
		"phone": "string",
		"email": "[email protected]",
		"role_type": 0,
		"vat_id": "string",
		"address_country": "string",
		"address_city": "string",
		"address_line1": "string",
		"address_line2": "string",
		"address_postal_code": "string"
	}
}

Properties

| 名稱 | 類型 | 必填 | 約束 | 說明 | | --------------------- | ----------------- | ----- | ---- | --------------------------------------------- | --- | ---- | ---- | --- | --- | ---- | --- | ------ | ---- | --- | ------ | ---- | --- | -------- | ---- | --- | ------ | --- | | id | integer | false | none | 訂單ID | | trade_no | string | false | none | 內部訂單編號 | | out_trade_no | string | false | none | 外部訂單編號 | | product_id | integer | false | none | 套餐ID | | product_type | integer | false | none | 套餐類型,見產品類型枚舉 | | amount | integer | false | none | 購買數量 | | unit_price | number(float) | false | none | 單價 | | total_fee | number(float) | false | none | 訂單總價(不含折扣,含手續費) | | goods_fee | number(float) | false | none | 商品價格(含折扣,不含手續費) | | pay_fee | number(float) | false | none | 實付金額(含折扣,含手續費) | | discount_fee | number(float) | false | none | 優惠金額 | | handling_fee | number(float) | false | none | 手續費 | | refund_fee | number(float) | false | none | 退款金額 | | pm_id | integer | false | none | 支付方式ID(來自 /api-gate-way/payment/list) | | pm_title | string | false | none | 支付方式名稱 | | pm_logo | string | false | none | 支付方式Logo URL | | status | integer | false | none | 訂單狀態
| 值 | 描述 |
| --- | --- |
| 0 | 待支付 |
| 1 | 已支付 |
| 2 | 超時取消 |
| 3 | 已退款 | | | title | string | false | none | 套餐標題 | | detail | string | false | none | 套餐描述 | | region_desc | string | false | none | 地區規格描述 | | pay_at | string(date-time) | false | none | 支付時間 | | pay_timestamp | integer | false | none | 支付時間戳 | | created_at | string(date-time) | false | none | 創建時間 | | pay_fee_status | integer | false | none | 長短款狀態:0正常 1長款(超額支付) 2短款 | | invoice | object | false | none | 發票信息(僅線上支付訂單有值) | | » name | string | false | none | 全名 | | » org_name | string | false | none | 企業名稱 | | » first_name | string | false | none | none | | » last_name | string | false | none | none | | » phone | string | false | none | none | | » email | string(email) | false | none | none | | » role_type | integer | false | none | 1個人 2企業 | | » vat_id | string | false | none | 稅號 | | » address_country | string | false | none | none | | » address_city | string | false | none | none | | » address_line1 | string | false | none | none | | » address_line2 | string | false | none | none | | » address_postal_code | string | false | none | none |

OrderCheckResult

{
	"product_id": 0,
	"amount": 0,
	"discount_fee": 0.1,
	"total_fee": 0.1,
	"pay_fee": 0.1,
	"product_type": 0,
	"title": "string",
	"detail": "string",
	"ip_result": [
		{
			"ip": "string",
			"price": 0.1,
			"country_code": "string",
			"current_time": "2019-08-24T14:15:22Z",
			"renewal_time": "2019-08-24T14:15:22Z",
			"country": {
				"name_zh_cn": "string",
				"flag": "string",
				"square_flag": "string"
			}
		}
	]
}

訂單預檢結果

Properties

名稱類型必填約束說明
product_idintegerfalsenone套餐ID
amountintegerfalsenone數量
discount_feenumber(float)falsenone優惠金額
total_feenumber(float)falsenone訂單總額
pay_feenumber(float)falsenone實付金額
product_typeintegerfalsenone套餐類型
titlestringfalsenone套餐標題
detailstringfalsenone套餐描述
ip_result[object]falsenoneIP批量續費結果(僅IP續費時返回)
» ipstringfalsenonenone
» pricenumber(float)falsenonenone
» country_codestringfalsenonenone
» current_timestring(date-time)falsenonenone
» renewal_timestring(date-time)falsenonenone
» countryobjectfalsenonenone
»» name_zh_cnstringfalsenonenone
»» flagstringfalsenone圓形旗幟URL
»» square_flagstringfalsenone方形旗幟URL

Product

{
	"id": 0,
	"title": "string",
	"type": 0,
	"show_type": 0,
	"status": 0,
	"price": 0.1,
	"usd_price": 0.1,
	"price_hkd": 0.1,
	"original_price": 0.1,
	"original_usd_price": 0.1,
	"original_price_hkd": 0.1,
	"local_price": 0.1,
	"local_original_price": 0.1,
	"preferred_currency": "string",
	"support_currencies": "string",
	"flow_value": 0.1,
	"flow_give": 0.1,
	"balance_give": 0.1,
	"balance_value": 0.1,
	"time_validity": 0.1,
	"time_price": 0.1,
	"time_days": 0,
	"tip1": "string",
	"tip2": "string",
	"introduce": ["string"],
	"region_list_id": 0,
	"renew_product_list": "string",
	"parent_product_type": 0,
	"total_count": 0,
	"remain_count": 0,
	"extension_of_time_days": [0],
	"time_days_price_rate": 0.1,
	"desc": {
		"subtitle": "string",
		"flow_value": 0.1,
		"flow_give": 0.1,
		"balance_give": 0.1,
		"time_validity": 0.1,
		"time_price": 0.1,
		"tip1": "string",
		"tip2": "string",
		"introduce": ["string"]
	},
	"sku": {
		"bandwidth_list": [
			{
				"id": 0,
				"value": 0,
				"price": 0.1,
				"price_usd": 0.1,
				"price_hkd": 0.1
			}
		],
		"duration_list": [
			{
				"id": 0,
				"value": 0,
				"price": 0.1,
				"price_usd": 0.1,
				"price_hkd": 0.1
			}
		],
		"concurrency_list": [
			{
				"id": 0,
				"value": 0,
				"price": 0.1,
				"price_usd": 0.1,
				"price_hkd": 0.1
			}
		]
	}
}

Properties

| 名稱 | 類型 | 必填 | 約束 | 說明 | | ---------------------- | ------------- | ----- | ---- | --------------------------------------------------- | --- | ---- | ---- | --- | --- | ---- | --- | -------- | ---- | --- | ---------------- | ---- | --- | ---------------- | ---- | --- | ------------------------------- | ---- | --- | --------------- | ---- | --- | ------------------ | ---- | --- | ------------------ | ---- | --- | --------------- | ---- | --- | ------------ | ---- | --- | -------------- | ---- | --- | -------------- | ---- | --- | -------------- | ---- | --- | -------------- | ---- | --- | ------------------ | ---- | --- | -------------- | --- | | id | integer | false | none | 套餐ID | | title | string | false | none | 套餐主標題 | | type | integer | false | none | 套餐類型
| 值 | 描述 |
| --- | --- |
| 3 | 餘額充值 |
| 9 | 動態住宅流量套餐 |
| 10 | 動態全球包時套餐 |
| 11 | 定製動態全球包時套餐V2(含SKU) |
| 12 | 長效IDC流量套餐 |
| 13 | 住宅靜態IP流量套餐 |
| 14 | 數據中心靜態IP套餐 |
| 15 | 長效ISP流量套餐 |
| 16 | 靜態流量套餐 |
| 17 | 動態住宅IP套餐 |
| 19 | 靜態IP續費套餐 |
| 20 | 靜態IP更換資格 |
| 21 | 靜態住宅IP套餐 |
| 24 | 靜態流量附加包套餐 |
| 25 | 靜態IP速率套餐 | | | show_type | integer | false | none | 展示類型:1普通 2大額推薦 3不可購買(需定製) 4試用 | | status | integer | false | none | 狀態:1上架 0下架 | | price | number(float) | false | none | 人民幣價格 | | usd_price | number(float) | false | none | 美元價格 | | price_hkd | number(float) | false | none | 港幣價格 | | original_price | number(float) | false | none | 原價(CNY) | | original_usd_price | number(float) | false | none | 原價(USD) | | original_price_hkd | number(float) | false | none | 原價(HKD) | | local_price | number(float) | false | none | 本地化價格(依賴 preferred_currency) | | local_original_price | number(float) | false | none | 本地化原價(依賴 preferred_currency) | | preferred_currency | string | false | none | 推薦顯示貨幣,如 usd / cny / hkd | | support_currencies | string | false | none | 支持的貨幣列表,逗號分隔,如 usd,cny | | flow_value | number(float) | false | none | 流量套餐默認流量(GB) | | flow_give | number(float) | false | none | 贈送流量(GB) | | balance_give | number(float) | false | none | 餘額充值贈送金額 | | balance_value | number(float) | false | none | 充值金額 | | time_validity | number(float) | false | none | 包量套餐默認有效時長 | | time_price | number(float) | false | none | 包量套餐每IP價格 | | time_days | integer | false | none | 有效期天數,如 30/90/180/365 | | tip1 | string | false | none | 標籤說明1 | | tip2 | string | false | none | 標籤說明2 | | introduce | [string] | false | none | 文本介紹列表 | | region_list_id | integer | false | none | 地區ID | | renew_product_list | string | false | none | 可續訂套餐ID列表(逗號分隔) | | parent_product_type | integer | false | none | 父套餐類型(type=19時有效):14或25 | | total_count | integer | false | none | 總庫存,0表示不限制 | | remain_count | integer | false | none | 剩餘庫存 | | extension_of_time_days | [integer] | false | none | 時長倍數列表,為空或僅含1表示不支持 | | time_days_price_rate | number(float) | false | none | 時長價格係數,價格 × (1 + (倍數-1) × rate) | | desc | object | false | none | 套餐描述信息 | | » subtitle | string | false | none | 副標題 | | » flow_value | number(float) | false | none | none | | » flow_give | number(float) | false | none | none | | » balance_give | number(float) | false | none | none | | » time_validity | number(float) | false | none | none | | » time_price | number(float) | false | none | none | | » tip1 | string | false | none | none | | » tip2 | string | false | none | none | | » introduce | [string] | false | none | none | | sku | object | false | none | 規格參數(type=11時返回) | | » bandwidth_list | [object] | false | none | 帶寬規格列表 | | »» id | integer | false | none | none | | »» value | integer | false | none | 帶寬值(Mbps) | | »» price | number(float) | false | none | none | | »» price_usd | number(float) | false | none | none | | »» price_hkd | number(float) | false | none | none | | » duration_list | [object] | false | none | 時長規格列表 | | »» id | integer | false | none | none | | »» value | integer | false | none | 時長(天) | | »» price | number(float) | false | none | none | | »» price_usd | number(float) | false | none | none | | »» price_hkd | number(float) | false | none | none | | » concurrency_list | [object] | false | none | 併發規格列表 | | »» id | integer | false | none | none | | »» value | integer | false | none | 併發數 | | »» price | number(float) | false | none | none | | »» price_usd | number(float) | false | none | none | | »» price_hkd | number(float) | false | none | none |

WhiteIp

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

Properties

名稱類型必填約束說明
idintegerfalsenonenone
ipstringfalsenonenone
remarkstringfalsenonenone
created_atstring(date-time)falsenonenone

WhitelistAccount

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

Properties

名稱類型必填約束說明
idintegerfalsenonenone
usernamestringfalsenonenone
limitintegerfalsenonenone
usedintegerfalsenonenone
statusintegerfalsenonenone

Coupon

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

Properties

名稱類型必填約束說明
idintegerfalsenonenone
namestringfalsenonenone
codestringfalsenonenone
discountnumber(float)falsenonenone
expire_timestring(date-time)falsenonenone

Article

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

Properties

名稱類型必填約束說明
idintegerfalsenonenone
titlestringfalsenonenone
contentstringfalsenonenone
created_atstring(date-time)falsenonenone

Pagination

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

Properties

名稱類型必填約束說明
totalintegerfalsenonenone
page_nointegerfalsenonenone
page_sizeintegerfalsenonenone
total_pagesintegerfalsenonenone