OpenAPI

app_key 認証キーは、ログイン後、個人センターのホームページでご確認ください。

キーは安全に保管してください。キーはあなたのアカウントの管理者権限を持ちます。

Base URLs:

認証

代理アカウント管理

GET プロキシ口座リスト

GET /openapi/whitelist-account/list

返される例

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

返される結果

ステータスコード	ステータスコードの意味	説明	データモデル
200	OK	リクエスト成功	インライン

返されるデータ構造

ステータスコード 200

名前	タイプ	必須	制約	説明
» code	responseCode	false	なし	ステータスコード, 200 成功、3 app_key 無効
» msg	string	偽	なし	ステータスメッセージ
» データ	オブジェクト	偽	なし	なし
»» リスト	[オブジェクト]	false	なし	なし
»»» id	整数	false	なし	アカウント番号
»»» username	文字列	偽	なし	代理アカウント名
»»» password	文字列	偽	なし	代理アカウントのパスワード
»»» created_at	文字列	false	なし	追加時間
»»» 備考	文字列	false	なし	備考
»»» product_type	productTypes	false	なし	プランタイプ、9 動的住宅トラフィックプラン、11 動的住宅 IP、14 静的データセンター IP、25 静的住宅 IP
»»» usage_flow	整数	偽	なし	使用済みトラフィック量 (KB)
»»» limit_flow	整数	偽	なし	カスタムトラフィック上限：単位 GB、最大 102400、0 は無制限
»»» status	整数	false	なし	有効ステータス：1 有効、0 停止

列挙値

属性	値
product_type	9
product_type	11
product_type	14
product_type	25

POST 代理アカウントを追加します。

POST /openapi/whitelist-account/add

Body リクエストパラメータ

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

リクエストパラメータ

名前	位置	タイプ	必須	説明
body	body	オブジェクト	いいえ	なし
» app_key	本文	文字列	いいえ	認証キー
» アカウント	本文	文字列	いいえ	アカウントパスワードは、username:password の形式で入力してください。アカウントとパスワードは数字とアルファベットのみをサポートし、特殊文字やスペースは使用できません。アカウントとパスワードはコロンで区切ってください。一括追加をサポートし、複数のアカウントは英語のコンマ（,）で区切ってください。
» 備考	本文	文字列	いいえ	代理アカウントの説明
» product_type	本文	productTypes	否	プランタイプ、9 動的住宅 IP プラン、11 動的住宅 IP、14 静的データセンター IP、25 静的住宅 IP

列挙値

属性	値
» product_type	9
» product_type	11
» product_type	14
» product_type	25

戻り値の例

200 Response

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

返される結果

ステータスコード	ステータスコードの意味	説明	データモデル
200	OK	リクエスト成功	インライン

返されるデータ構造

ステータスコード 200

名称	タイプ	必須	制約	説明
» code	整数	偽	なし	ステータスコード、200 成功、3 app_key 無効、156 アカウント未実名認証
» メッセージ	文字列	偽	なし	ステータスメッセージ
» data	null	false	なし	なし

POST 削除プロキシアカウント

POST /openapi/whitelist-account/delete

削除すると復元できませんのでご注意ください。使用したトラフィックなどは照会できません。削除には約 5 分間の待ち時間があり、この間も料金が発生する可能性があります。

Body リクエストパラメータ

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

リクエストパラメータ

名称	位置	类型	必須	説明
ボディー	ボディー	オブジェクト	否	なし
» app_key	body	文字列	いいえ	認証キー
» accounts	body	文字列	いいえ	代理アカウント、数字とアルファベットのみをサポートします。一括操作をサポートし、英語のコンマ（,）で代理アカウントを区切ります。

戻り値の例

200 レスポンス

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

返される結果

ステータスコード	ステータスコードの意味	説明	データモデル
200	OK	リクエスト成功	インライン

返されるデータ構造

ステータスコード 200

名称	タイプ	必須	制約	説明
» コード	整数	偽	なし	ステータスコード,200 成功、3 app_key 無効、156 アカウント未実名認証
» msg	string	false	なし	ステータスメッセージ
» データ	ヌル	false	none	none

POST でプロキシアカウントは無効になっています

POST /openapi/whitelist-account/disable

無効化には約 5 分の待ち時間があり、この間も料金が発生する可能性があります。

Body リクエストパラメータ

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

リクエストパラメータ

名前	位置	タイプ	必須	説明
body	body	object	否	なし
» app_key	body	文字列	いいえ	認証キー
» accounts	body	string	否	代理アカウント。数字とアルファベットのみをサポートします。一括操作をサポートし、代理アカウントは英語のコンマ（,）で区切ります。

返される例

200 レスポンス

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

返される結果

ステータスコード	状態コードの意味	説明	データモデル
200	OK	リクエスト成功	インライン

返されるデータ構造

ステータスコード 200

名前	タイプ	必須	制約	説明
» code	整数	false	なし	ステータスコード, 200 成功、3 app_key 無効、156 アカウント未実名認証
» msg	string	偽	なし	ステータスメッセージ
» データ	ヌル	偽	なし	なし

POST プロキシアカウントの有効化

POST /openapi/whitelist-account/enable

Body リクエストパラメータ

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

リクエストパラメータ

名前	位置	タイプ	必須	説明
body	body	object	否	なし
» app_key	body	文字列	いいえ	認証キー
» accounts	body	string	否	代理アカウント。数字とアルファベットのみをサポートします。一括操作をサポートし、複数のアカウントは英語のコンマ（,）で区切ります。

返される例

200 レスポンス

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

返される結果

ステータスコード	状態コードの意味	説明	データモデル
200	OK	リクエスト成功	インライン

返されるデータ構造

ステータスコード 200

名前	タイプ	必須	制約	説明
» code	整数	false	なし	ステータスコード, 200 成功、3 app_key 無効、156 アカウント未実名認証
» msg	string	偽	なし	ステータスメッセージ
» データ	ヌル	偽	なし	なし

POST 代理アカウントのパスワード変更

POST /openapi/whitelist-account/change-password

変更後、5 分間の待機時間があります。この間、古いパスワードも引き続き正常に使用できる可能性がありますのでご注意ください。

Body リクエストパラメータ

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

リクエストパラメータ

名前	位置	タイプ	必須	説明
body	body	オブジェクト	いいえ	なし
» app_key	本文	文字列	いいえ	認証キー
» アカウント	本文	文字列	いいえ	代理アカウント、数字とアルファベットのみをサポートします。
» password	body	string	否	代理アカウントの新しいパスワードは、数字と文字のみをサポートします。

戻り値の例

200 Response

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

返される結果

ステータスコード	ステータスコードの意味	説明	データモデル
200	OK	リクエスト成功	インライン

返されるデータ構造

ステータスコード 200

名称	タイプ	必須	制約	説明
» code	整数	偽	なし	ステータスコード、200 成功、3 app_key 無効、156 アカウント未実名認証
» メッセージ	文字列	偽	なし	ステータスメッセージ
» data	null	false	なし	なし

POST 代理アカウントの備考を修正

POST /openapi/whitelist-account/change-remark

Body リクエストパラメータ

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

リクエストパラメータ

名称	位置	種類	必須	説明
body	体	オブジェクト	否	なし
» app_key	本文	文字列	いいえ	認証キー
» アカウント	本文	文字列	いいえ	代理アカウントは、数字と文字のみをサポートします。
» 備考	body	文字列	否	代理アカウントの新しい備考。32 文字（中国語）または 64 文字（英語）以内。

戻り値の例

200 レスポンス

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

返される結果

ステータスコード	ステータスコードの意味	説明	データモデル
200	OK	リクエスト成功	インライン

返されるデータ構造

ステータスコード 200

名称	タイプ	必須	制約	説明
» code	整数	偽	なし	ステータスコード、200 成功、3 app_key 無効、156 アカウント未実名認証
» メッセージ	文字列	偽	なし	ステータスメッセージ
» data	null	false	なし	なし

POST 代理アカウントのトラフィック制限の変更

POST /openapi/whitelist-account/change-limit

トラフィック統計には最大 5 分程度の遅延が発生する可能性があることにご注意ください。つまり、実際の消費トラフィックがこの制限を超える可能性があります。

Body リクエストパラメータ

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

リクエストパラメータ

名称	位置	类型	必須	説明
ボディー	ボディー	オブジェクト	否	なし
» app_key	body	文字列	否	認証キー
» account	body	文字列	いいえ	代理アカウントは、数字と文字のみをサポートします。
» limit	body	integer	否	流量制限、単位：GB、0 は上限なし

返される例

200 レスポンス

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

返される結果

ステータスコード	状態コードの意味	説明	データモデル
200	OK	リクエスト成功	インライン

返されるデータ構造

ステータスコード 200

名前	タイプ	必須	制約	説明
» code	整数	false	なし	ステータスコード, 200 成功、3 app_key 無効、156 アカウント未実名認証
» msg	string	偽	なし	ステータスメッセージ
» データ	ヌル	偽	なし	なし

トラフィックログクエリ

GET 使用流量按天汇总

GET /openapi/user-usage-flow/total

リクエストパラメータ

名称	位置	类型	必須	説明
app_key	query	string(password)	はい	認証キー
start_time	query	string(Y-m-d H:i:s)	いいえ	開始時間、秒まで正確に指定できます。ログ記録には 5 分以内の遅延があることにご注意ください。デフォルトは 7 日以内です。
end_time	query	string(Y-m-d H:i:s)	否	締め切り時間。秒まで正確に指定できます。ログ記録には 5 分以内の遅延があることにご注意ください。デフォルトは現在の時間です。
username	クエリ	文字列	いいえ	子アカウント名。デフォルトではすべてのアカウントがクエリされます。特定の子アカウントを指定することもできます。同じ名前の子アカウントを追加した場合、このクエリは同じ名前の代理店アカウントのすべての使用記録を返すことに注意してください。
製品タイプ	クエリ	数値	いいえ	套餐タイプ

返却例

200 Response

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

返却結果

ステータスコード	ステータスコードの意味	説明	データモデル
200	OK	リクエスト成功	インライン

返されるデータ構造

ステータスコード 200

名称	タイプ	必須	制約	説明
» code	整数	false	none	ステータスコード: 200 成功、3 app_key 無効、156 アカウント未実名認証
» msg	文字列	偽	なし	ステータスメッセージ
» データ	オブジェクト	false	なし	なし
»» リスト	[オブジェクト]	false	なし	なし
»»» 日	文字列	false	なし	日付
»»» フロー	整数	偽	なし	消費流量 (単位: KB)

套餐照会

購入済みプランリストを取得

GET /openapi/user-product/list

リクエストパラメータ

名称	位置	类型	必須	説明
app_key	query	文字列（パスワード）	はい	認証キー
trade_no	クエリ	文字列	いいえ	注文番号、完全な注文番号を入力してください。あいまい検索はサポートされていません。
ページ	クエリ	番号	いいえ	ページネーション、デフォルト：1
サイズ	クエリ	番号	否	ページネーション表示数、デフォルト：20
製品タイプ	クエリ	数値	いいえ	プランタイプ

返却例

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

返却結果

ステータスコード	ステータスコードの意味	説明	データモデル
200	OK	リクエスト成功	インライン

返されるデータ構造

ステータスコード 200

名称	タイプ	必須	制約	説明
» code	整数	false	none	ステータスコード: 200 成功、3 app_key 無効、156 アカウント未実名認証
» msg	文字列	false	なし	ステータスメッセージ
» データ	オブジェクト	false	なし	なし
»» リスト	[オブジェクト]	false	なし	なし
»»» id	整数	偽	なし	パッケージ ID
»»» created_at	文字列	偽	なし	プラン有効時間
»»» expired_at	文字列	false	なし	套餐の有効期限が過ぎると、トラフィックは使用できなくなります。
»»» product_type	productTypes	false	なし	プランタイプ、9 動的住宅 IP プラン、11 動的住宅 IP、14 静的データセンター IP、25 静的住宅 IP
»»» trade_no	string	偽	なし	注文取引番号
»»» 注文	オブジェクト	false	なし	なし
»»»» created_at	文字列	false	なし	注文作成時間
»»»» pay_at	string	false	なし	注文支払い時間
»»»» title	string	偽	なし	注文内容
»» ページ	整数	偽	なし	現在のページ
»» page_size	整数	false	なし	ページサイズ
»» total_count	整数	false	なし	総レコード数
»» total_page	整数	false	なし	総ページ数

列挙値

属性	値
product_type	9
product_type	11
製品タイプ	14
製品タイプ	25

IP 抽出

GET IP 抽出

GET /openapi/ip/v3

リクエストパラメータ

名前	位置	タイプ	必須	説明
app_key	query	パスワード（文字列）	いいえ	アクセスキー
cc	クエリ	文字列	いいえ	国または地域
状態	クエリ	文字列	いいえ	省または州
市区町村	クエリ	文字列	いいえ	都市
format	query	文字列	いいえ	形式を取得
lb	クエリ	文字列	否	区切り文字、text 形式のみ有効
数	クエリ	番号	否	抽出数
life	query	number	いいえ	保持期間 - 分
ep	query	文字列	いいえ	プロキシネットワーク

返却例

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

返される結果

ステータスコード	ステータスコードの意味	説明	データモデル
200	OK	リクエスト成功	インライン

返されるデータ構造

ステータスコード 200

名称	タイプ	必須	制約	説明
» コード	整数	偽	なし	ステータスコード,200 成功、3 app_key 無効、156 アカウント未実名認証
» msg	string	false	なし	ステータスメッセージ
» データ	オブジェクト	false	none	none
»» リスト	[任意]	偽	なし	なし

GET 都市リスト

GET /openapi/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": null,
						"state": null,
						"continent_code": null,
						"country_code": null
					}
				]
			}
		]
	}
}

返される結果

ステータスコード	ステータスコードの意味	説明	データモデル
200	OK	リクエスト成功	インライン

返されるデータ構造

ステータスコード 200

名称	タイプ	必須	制約	説明
» code	整数	偽	なし	ステータスコード、200 成功、3 app_key 無効、156 アカウント未実名認証
» メッセージ	文字列	偽	なし	ステータスメッセージ
» data	object	false	なし	なし
»» リスト	[オブジェクト]	偽	なし	リスト
»»» name_zh_cn	文字列	偽	なし	国または地域名
»»» name_en	文字列	false	なし	国または地域名
»»» continent_code	string	false	なし	大洲コード
»»» country_code	文字列	偽	なし	国または地域コード
»»» items	[オブジェクト]	false	なし	省または州
»»»» 市	文字列	偽	なし	都市名
»»»» state	string	false	なし	省または州の名称コード
»»»» continent_code	string	false	none	大洲コード
»»»» country_code	文字列	false	なし	国または地域コード

GET 都市検索

GET /openapi/ip/dynamic-citys/search

リクエストパラメータ

名称	位置	类型	必須	説明
国コード	クエリ	文字列	はい	国または地域コード
状態	クエリ	文字列	はい	州または省コード

返される例

200 レスポンス

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

返される結果

ステータスコード	ステータスコードの意味	説明	データモデル
200	OK	リクエスト成功	インライン

返されるデータ構造

ステータスコード 200

名称	タイプ	必須	制約	説明
» code	整数	false	none	ステータスコード: 200 成功、3 app_key 無効、156 アカウント未実名認証
» msg	文字列	偽	なし	ステータスメッセージ
» データ	オブジェクト	false	なし	なし
»» リスト	[文字列]	false	なし	リスト

GET 州リスト

GET /openapi/ip/dynamic-states

返される例

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

返される結果

ステータスコード	状態コードの意味	説明	データモデル
200	OK	リクエスト成功	インライン

返されるデータ構造

ステータスコード 200

名前	タイプ	必須	制約	説明
» code	整数	false	なし	ステータスコード, 200 成功、3 app_key 無効、156 アカウント未実名認証
» msg	string	偽	なし	ステータスメッセージ
» データ	オブジェクト	false	なし	なし
»» リスト	[オブジェクト]	false	なし	リスト
»»» name_zh_cn	文字列	偽	なし	国または地域名
»»» name_en	文字列	false	none	国または地域名
»»» continent_code	文字列	false	なし	Dazhou コード
»»» 国コード	文字列	false	なし	国または地域コード
»»» 項目	[object]	false	なし	省または州
»»»» state	string	偽	なし	省または州名コード
»»»» continent_code	文字列	false	なし	Dazhou コード
»»»» 国コード	文字列	偽	なし	国または地域コード

GET 州/省検索

GET /openapi/ip/dynamic-states/search

リクエストパラメータ

名前	位置	タイプ	必須	説明
country_code	query	string	はい	国または地域コード

返される例

200 Response

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

返される結果

ステータスコード	ステータスコードの意味	説明	データモデル
200	OK	リクエスト成功	インライン

返されるデータ構造

ステータスコード 200

名称	タイプ	必須	制約	説明
» code	整数	偽	なし	ステータスコード、200 成功、3 app_key 無効、156 アカウント未実名認証
» メッセージ	文字列	偽	なし	ステータスメッセージ
» data	object	false	none	none
»» リスト	[文字列]	偽	なし	リスト

GET 静的 IP リストの取得

GET /ip/get-static-ip

リクエストパラメータ

名称	位置	类型	必須	説明
国コード	クエリ	文字列	いいえ	国または地域コード
product_type	クエリ	番号	否	製品タイプ, 25: 静的住宅 IP, 14: データセンター IP
trade_no	query	文字列	いいえ	注文番号で IP をフィルタリング
ページ	クエリ	番号	いいえ	ページ番号
サイズ	クエリ	数	いいえ	1 ページあたりの数量
ステータス	クエリ	番号	否	ステータス, 1:有効, 2:無効, 3:まもなく期限切れ, 4:メンテナンス中

列挙値

属性	値
product_type	14
product_type	25
status	1
ステータス	2
ステータス	3
ステータス	4

戻り値の例

200 レスポンス

{}

返される結果

ステータスコード	ステータスコードの意味	説明	データモデル
200	OK	なし	インライン

返されるデータ構造

データモデル

productTypes

プランタイプ、9 動的住宅 IP プラン、11 動的住宅 IP、14 静的データセンター IP、25 静的住宅 IP

属性

名称	タイプ	必須	制約	中国語名	説明
anonymous	integer	false	なし		プランの種類、9 動的住宅 IP プラン、11 動的住宅 IP、14 静的データセンター IP、25 静的住宅 IP

列挙値

属性	値
anonymous	9
anonymous	11
anonymous	14
匿名	25

apiKey

null

認証キー

属性

None

responseCode

ステータスコード, 200 成功、3 app_key 無効

属性

名称	タイプ	必須	制約	中国語名	説明
anonymous	integer	false	none		ステータスコード, 200 成功、3 app_key 無効

responseMsg

"success"

レスポンスメッセージ

属性

名称	タイプ	必須	制約	中国語名	説明
匿名	文字列	偽	なし		応答メッセージ