OpenAPI DocOpenAPI Doc
  • NaProxy

NaProxy

app_key authentication key can be viewed on the personal center homepage after logging in.

Please keep the key safe, as it has administrator privileges for your account.

Authentication Methods

App Key Authentication

POST parameters:

app_key: {your_app_key}

Or as query parameter:

?app_key={your_app_key}

Response Format

All APIs return a unified JSON format:

{
	"code": 200,
	"message": "Operation successful",
	"data": {}
}
  • code: Status code, 200 indicates success, other values indicate failure
  • message: Response message
  • data: Response data

Base URLs:

Authentication

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

Proxy Account Management

GET Proxy Account List

GET /api-gate/whitelist-account/list

Response Example

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

Response Result

Status CodeStatus Code MeaningDescriptionData Model
200OKRequest successfulInline

Response Data Structure

Status Code 200

NameTypeRequiredConstraintChinese NameDescription
» coderesponseCodefalsenoneStatus code, 200 success, 3 app_key invalid
» msgstringfalsenoneStatus message
» dataobjectfalsenonenone
»» list[object]falsenonenone
»»» idintegerfalsenoneAccount ID
»»» usernamestringfalsenoneProxy account username
»»» passwordstringfalsenoneProxy account password
»»» created_atstringfalsenoneCreation time
»»» remarkstringfalsenoneRemark
»»» product_typeproductTypesfalsenonePackage type, 9 Dynamic Residential Traffic Package, 11 Dynamic Residential IP, 14 Static Data Center IP, 25 Static Residential IP
»»» usage_flowintegerfalsenoneUsed traffic, unit: KB
»»» limit_flowintegerfalsenoneCustom traffic limit: unit GB, max 102400, 0 for unlimited
»»» statusintegerfalsenoneEnable status: 1 enabled, 0 disabled

Enum Values

PropertyValue
product_type9
product_type11
product_type14
product_type25

POST Add Proxy Account

POST /api-gate/whitelist-account/add

Body Request Parameters

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

Request Parameters

NameLocationTypeRequiredDescription
bodybodyobjectnonone
» app_keybodystringnoAuthorization key
» accountsbodystringnoAccount password, please fill in the format username:password, account and password only support numbers and letters, no special symbols or spaces allowed, colon separates account and password. Supports batch addition, separated by English comma (,).
» remarkbodystringnoProxy account description
» product_typebodyproductTypesnoPackage type, 9 Dynamic Residential Traffic Package, 11 Dynamic Residential IP, 14 Static Data Center IP, 25 Static Residential IP

Enum Values

PropertyValue
» product_type9
» product_type11
» product_type14
» product_type25

Response Example

200 Response

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

Response Result

Status CodeStatus Code MeaningDescriptionData Model
200OKRequest successfulInline

Response Data Structure

Status Code 200

NameTypeRequiredConstraintChinese NameDescription
» codeintegerfalsenoneStatus code, 200 success, 3 app_key invalid, 156 account not verified
» msgstringfalsenoneStatus message
» datanullfalsenonenone

POST Delete Proxy Account

POST /api-gate/whitelist-account/delete

Please note that deletion cannot be recovered, and used traffic cannot be queried. Deletion has a waiting period of about 5 minutes, during which fees may still be incurred.

Body Request Parameters

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

Request Parameters

NameLocationTypeRequiredDescription
bodybodyobjectnonone
» app_keybodystringnoAuthorization key
» accountsbodystringnoProxy accounts, only supports numbers and letters. Supports batch operation, separated by English comma (,)

Response Example

200 Response

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

Response Result

Status CodeStatus Code MeaningDescriptionData Model
200OKRequest successfulInline

Response Data Structure

Status Code 200

NameTypeRequiredConstraintChinese NameDescription
» codeintegerfalsenoneStatus code, 200 success, 3 app_key invalid, 156 account not verified
» msgstringfalsenoneStatus message
» datanullfalsenonenone

POST Disable Proxy Account

POST /api-gate/whitelist-account/disable

Disabling has a waiting period of about 5 minutes, during which fees may still be incurred.

Body Request Parameters

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

Request Parameters

NameLocationTypeRequiredDescription
bodybodyobjectnonone
» app_keybodystringnoAuthorization key
» accountsbodystringnoProxy accounts, only supports numbers and letters. Supports batch operation, separated by English comma (,)

Response Example

200 Response

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

Response Result

Status CodeStatus Code MeaningDescriptionData Model
200OKRequest successfulInline

Response Data Structure

Status Code 200

NameTypeRequiredConstraintChinese NameDescription
» codeintegerfalsenoneStatus code, 200 success, 3 app_key invalid, 156 account not verified
» msgstringfalsenoneStatus message
» datanullfalsenonenone

POST Enable Proxy Account

POST /api-gate/whitelist-account/enable

Body Request Parameters

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

Request Parameters

NameLocationTypeRequiredDescription
bodybodyobjectnonone
» app_keybodystringnoAuthorization key
» accountsbodystringnoProxy accounts, only supports numbers and letters. Supports batch operation, separated by English comma (,)

Response Example

200 Response

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

Response Result

Status CodeStatus Code MeaningDescriptionData Model
200OKRequest successfulInline

Response Data Structure

Status Code 200

NameTypeRequiredConstraintChinese NameDescription
» codeintegerfalsenoneStatus code, 200 success, 3 app_key invalid, 156 account not verified
» msgstringfalsenoneStatus message
» datanullfalsenonenone

POST Change Proxy Account Password

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

Please note that after modification, there is a 5-minute waiting period during which the old password may still work.

Body Request Parameters

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

Request Parameters

NameLocationTypeRequiredDescription
bodybodyobjectnonone
» app_keybodystringnoAuthorization key
» accountbodystringnoProxy account, only supports numbers and letters.
» passwordbodystringnoNew proxy account password, only supports numbers and letters.

Response Example

200 Response

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

Response Result

Status CodeStatus Code MeaningDescriptionData Model
200OKRequest successfulInline

Response Data Structure

Status Code 200

NameTypeRequiredConstraintChinese NameDescription
» codeintegerfalsenoneStatus code, 200 success, 3 app_key invalid, 156 account not verified
» msgstringfalsenoneStatus message
» datanullfalsenonenone

POST Change Proxy Account Remark

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

Body Request Parameters

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

Request Parameters

NameLocationTypeRequiredDescription
bodybodyobjectnonone
» app_keybodystringnoAuthorization key
» accountbodystringnoProxy account, only supports numbers and letters.
» remarkbodystringnoNew proxy account remark, within 32 Chinese characters or 64 English characters.

Response Example

200 Response

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

Response Result

Status CodeStatus Code MeaningDescriptionData Model
200OKRequest successfulInline

Response Data Structure

Status Code 200

NameTypeRequiredConstraintChinese NameDescription
» codeintegerfalsenoneStatus code, 200 success, 3 app_key invalid, 156 account not verified
» msgstringfalsenoneStatus message
» datanullfalsenonenone

POST Change Proxy Account Traffic Limit

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

Please note that traffic statistics may have a delay of up to 5 minutes, meaning actual traffic consumption may exceed this limit.

Body Request Parameters

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

Request Parameters

NameLocationTypeRequiredDescription
bodybodyobjectnonone
» app_keybodystringnoAuthorization key
» accountbodystringnoProxy account, only supports numbers and letters.
» limitbodyintegernoTraffic limit, unit: GB, 0 for no limit

Response Example

200 Response

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

Response Result

Status CodeStatus Code MeaningDescriptionData Model
200OKRequest successfulInline

Response Data Structure

Status Code 200

NameTypeRequiredConstraintChinese NameDescription
» codeintegerfalsenoneStatus code, 200 success, 3 app_key invalid, 156 account not verified
» msgstringfalsenoneStatus message
» datanullfalsenonenone

Traffic Log Query

GET Traffic Usage Summary by Day

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

Request Parameters

NameLocationTypeRequiredDescription
app_keyquerystring(password)yesAuthentication key
start_timequerystring(Y-m-d H:i:s)noStart time, can be accurate to seconds. Please note that log recording has a delay within 5 minutes. Default is within 7 days.
end_timequerystring(Y-m-d H:i:s)noEnd time, can be accurate to seconds. Please note that log recording has a delay within 5 minutes. Default is current time.
usernamequerystringnoSub-account name, default queries all accounts, can specify sub-account. Please note if you have added sub-accounts with the same name, this query will return all usage records for proxy accounts with the same name.
product_typequerynumbernoPackage type

Response Example

200 Response

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

Response Result

Status CodeStatus Code MeaningDescriptionData Model
200OKRequest successfulInline

Response Data Structure

Status Code 200

NameTypeRequiredConstraintChinese NameDescription
» codeintegerfalsenoneStatus code, 200 success, 3 app_key invalid, 156 account not verified
» msgstringfalsenoneStatus message
» dataobjectfalsenonenone
»» list[object]falsenonenone
»»» daystringfalsenoneDate
»»» flowintegerfalsenoneTraffic consumed, unit KB

Package Query

GET Purchased Package List

GET /api-gate/user-product/list

Request Parameters

NameLocationTypeRequiredDescription
app_keyquerystring(password)yesAuthentication key
trade_noquerystringnoOrder number, please enter complete order number. Fuzzy search not supported.
pagequerynumbernoPage number, default: 1
sizequerynumbernoPage size, default: 20
product_typequerynumbernoPackage type

Response Example

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": "Entry Level"
				}
			}
		],
		"page": 1,
		"page_size": 20,
		"total_count": 0,
		"total_page": 0
	}
}

Response Result

Status CodeStatus Code MeaningDescriptionData Model
200OKRequest successfulInline

Response Data Structure

Status Code 200

NameTypeRequiredConstraintChinese NameDescription
» codeintegerfalsenoneStatus code, 200 success, 3 app_key invalid, 156 account not verified
» msgstringfalsenoneStatus message
» dataobjectfalsenonenone
»» list[object]falsenonenone
»»» idintegerfalsenonePackage ID
»»» created_atstringfalsenonePackage effective time
»»» expired_atstringfalsenonePackage expiration time, traffic cannot be used after expiration.
»»» product_typeproductTypesfalsenonePackage type, 9 Dynamic Residential Traffic Package, 11 Dynamic Residential IP, 14 Static Datacenter IP, 25 Static Residential IP
»»» trade_nostringfalsenoneOrder transaction number
»»» orderobjectfalsenonenone
»»»» created_atstringfalsenoneOrder creation time
»»»» pay_atstringfalsenoneOrder payment time
»»»» titlestringfalsenoneOrder description
»» pageintegerfalsenoneCurrent page
»» page_sizeintegerfalsenonePage size
»» total_countintegerfalsenoneTotal record count
»» total_pageintegerfalsenoneTotal page count

Enum Values

PropertyValue
product_type9
product_type11
product_type14
product_type25

IP Extraction

GET Extract IP

GET /api-gate/ip/v3

Request Parameters

NameLocationTypeRequiredDescription
app_keyquerystring(password)yesAccess key
ccquerystringnoCountry or region
statequerystringnoProvince or state
cityquerystringnoCity
formatquerystringnoOutput format
lbquerystringnoSeparator, only valid for text format
numquerynumbernoExtraction quantity
lifequerynumbernoSession duration - minutes
epquerystringnoProxy network

Enum Values

PropertyValue
epus
ephk
epde

Response Example

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

Response Result

Status CodeStatus Code MeaningDescriptionData Model
200OKRequest successfulInline

Response Data Structure

Status Code 200

NameTypeRequiredConstraintChinese NameDescription
» codeintegerfalsenoneStatus code, 200 success, 3 app_key invalid, 156 account not verified
» msgstringfalsenoneStatus message
» dataobjectfalsenonenone
»» list[any]falsenonenone

GET City List

GET /api-gate/ip/dynamic-citys

Response Example

200 Response

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

Response Result

Status CodeStatus Code MeaningDescriptionData Model
200OKRequest successfulInline

Response Data Structure

Status Code 200

NameTypeRequiredConstraintChinese NameDescription
» codeintegerfalsenoneStatus code, 200 success, 3 app_key invalid, 156 account not verified
» msgstringfalsenoneStatus message
» dataobjectfalsenonenone
»» list[object]falsenoneList
»»» name_zh_cnstringfalsenoneCountry or region name
»»» name_enstringfalsenoneCountry or region name
»»» continent_codestringfalsenoneContinent code
»»» country_codestringfalsenoneCountry or region code
»»» items[object]falsenoneProvince or state
»»»» citystringfalsenoneCity name
»»»» statestringfalsenoneProvince or state name code
»»»» continent_codestringfalsenoneContinent code
»»»» country_codestringfalsenoneCountry or region code

GET City Search

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

Request Parameters

NameLocationTypeRequiredDescription
country_codequerystringyesCountry or region code
statequerystringyesState or province code

Response Example

200 Response

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

Response Result

Status CodeStatus Code MeaningDescriptionData Model
200OKRequest successfulInline

Response Data Structure

Status Code 200

NameTypeRequiredConstraintChinese NameDescription
» codeintegerfalsenoneStatus code, 200 success, 3 app_key invalid, 156 account not verified
» msgstringfalsenoneStatus message
» dataobjectfalsenonenone
»» list[string]falsenoneList

GET State List

GET /api-gate/ip/dynamic-states

Response Example

200 Response

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

Response Result

Status CodeStatus Code MeaningDescriptionData Model
200OKRequest successfulInline

Response Data Structure

Status Code 200

NameTypeRequiredConstraintChinese NameDescription
» codeintegerfalsenoneStatus code, 200 success, 3 app_key invalid, 156 account not verified
» msgstringfalsenoneStatus message
» dataobjectfalsenonenone
»» list[object]falsenoneList
»»» name_zh_cnstringfalsenoneCountry or region name
»»» name_enstringfalsenoneCountry or region name
»»» continent_codestringfalsenoneContinent code
»»» country_codestringfalsenoneCountry or region code
»»» items[object]falsenoneProvince or state
»»»» statestringfalsenoneProvince or state name code
»»»» continent_codestringfalsenoneContinent code
»»»» country_codestringfalsenoneCountry or region code

GET State/Province Search

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

Request Parameters

NameLocationTypeRequiredDescription
country_codequerystringyesCountry or region code

Response Example

200 Response

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

Response Result

Status CodeStatus Code MeaningDescriptionData Model
200OKRequest successfulInline

Response Data Structure

Status Code 200

NameTypeRequiredConstraintChinese NameDescription
» codeintegerfalsenoneStatus code, 200 success, 3 app_key invalid, 156 account not verified
» msgstringfalsenoneStatus message
» dataobjectfalsenonenone
»» list[string]falsenoneList

GET Extract Purchased Static IP List

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

Request Parameters

NameLocationTypeRequiredDescription
country_codequerystringnoCountry or region code
product_typequerynumbernoProduct type, 25: Static Residential IP, 14: Datacenter IP
trade_noquerystringnoFilter IP by order number
pagequerynumbernoPage number
sizequerynumbernoItems per page
statusquerynumbernoStatus, 1: Valid, 2: Invalid, 3: Expiring soon, 4: Under maintenance

Enum Values

PropertyValue
product_type14
product_type25
status1
status2
status3
status4

Response Example

200 Response

{}

Response Result

Status CodeStatus Code MeaningDescriptionData Model
200OKnoneInline

Response Data Structure

GET Get Available Static IP Count by Region

GET /api-gate/static-ip-region

Request Parameters

NameLocationTypeRequiredDescription
ispquerystringnoIP type

Detailed Description

isp: IP Type

IP TypeDescription
1Residential Static IP
0Data Center Static IP

Response Example

200 Response

{
	"code": 200,
	"msg": "Request successful",
	"data": {
		"list": [
			{
				"code": "US",
				"number": 55
			}
		]
	}
}

Response Result

Status CodeStatus Code MeaningDescriptionData Model
200OKRequest successfulInline

Response Data Structure

Status Code 200

NameTypeRequiredConstraintChinese NameDescription
» codeintegerfalsenoneStatus code, 200 success
» msgstringfalsenoneStatus message
» dataobjectfalsenonenone
»» list[object]falsenonenone
»»» codestringfalsenoneCountry or region code
»»» numberintegerfalsenoneQuantity

Order Management

GET Order List

GET /api-gate/order/list

Request Parameters

NameLocationTypeRequiredDescription
page_noqueryintegernonone
page_sizequeryintegernonone
trade_noquerystringnoOrder number
statusqueryintegernoOrder status
product_typequeryintegernoProduct type

Detailed Description

status: Order Status

StatusDescription
0Pending Payment
1Paid
2Cancelled Due to Timeout
3Refunded

product_type: Product Type | Product Type | Description | |---|---| |3|Balance Recharge| |9|Dynamic Traffic Package| |11|Dynamic Global Time-based Package V2| |12|Long-term IDC Traffic Package| |13|Residential Static IP Traffic Package| |14|Data Center Static IP Package| |15|Long-term ISP Traffic Package| |16|Static Traffic Package| |17|Dynamic IP Quantity Package| |18|web-scraper| |19|Static IP Renewal| |20|Static IP Change Quota| |21|Static Traffic Package v2| |24|Static Traffic Add-on Package| |25|Residential Static IP Package| |26|Supplementary Order - Some payment channels require users to manually enter the amount, such as virtual currency. If there is a shortage, contact customer service to make up the payment through this product| |27|Serp| |28|Video|

Enum Values

PropertyValue
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

Response Example

200 Response

{
	"code": 0,
	"message": "Operation successful",
	"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
		}
	}
}

Response Result

Status CodeStatus Code MeaningDescriptionData Model
200OKSuccessInline

Response Data Structure

POST Create Order

POST /api-gate/order/create

Due to the variety of package types and different configurations for each package, please fill in the parameters according to the actual situation. Improper parameter filling may cause order creation to fail.

examples:

Renew Static IP

{
	"pid": x, // Contact customer service to obtain
	"upids": "1,2,3,4,5,6", // Obtain corresponding IDs from /api-gate/ip/get-static-ip
	"pm_id": 1 // Obtain from /api-gate/payment/list
	"coupon_sn: "xxx", // Optional coupon
  }

Body Request Parameters

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

Request Parameters

NameLocationTypeRequiredDescription
bodybodyobjectyesnone
» pidbodyintegeryesPackage ID
» upidsbodystringnoRenewal package ID list
» amountbodynumbernoNew purchase package quantity
» pm_idbodyintegeryesPayment method ID
» region_listbodystringnoSpecify region + quantity when purchasing static IP
» coupon_snbodystringnoCoupon number
» use_invitation_registration_discountbodybooleannoWhether to use invitation registration discount
» renew_durationbodyintegernoRenewal duration - optional for static IP
» product_sku_bandwidth_idbodyintegernoPackage 11: Bandwidth package ID
» product_sku_concurrency_idbodyintegernoPackage 11: Concurrency package ID
» recharge_amountbodyintegernoPackage 3: Recharge amount

Response Example

200 Response

{
	"code": 0,
	"message": "Operation successful",
	"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"
	}
}

Response Result

Status CodeStatus Code MeaningDescriptionData Model
200OKCreate successfulInline

Response Data Structure

POST Cancel Order

POST /api-gate/order/close

Body Request Parameters

{
	"trade_no": "string"
}

Request Parameters

NameLocationTypeRequiredDescription
bodybodyobjectyesnone
» trade_nobodystringyesnone

Response Example

200 Response

{
	"code": 0,
	"message": "Operation successful",
	"data": {}
}

Response Result

Status CodeStatus Code MeaningDescriptionData Model
200OKOperation successfulSuccessResponse

User Management

GET Get User Information - Not Yet Available

GET /api-gate/user/info

Response Example

200 Response

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

Response Result

Status CodeStatus Code MeaningDescriptionData Model
200OKSuccessInline

Response Data Structure

Payment Management

GET Get Payment Method List

GET /api-gate/payment/groups

Request Parameters

NameLocationTypeRequiredDescription
trade_noquerystringnoOrder number - can be passed when partial orders need to obtain specific payment methods

Response Example

200 Response

{
	"code": 0,
	"message": "Operation successful",
	"data": {
		"list": [
			{
				"name": "string",
				"logos": [null],
				"items": [null]
			}
		]
	}
}

Response Result

Status CodeStatus Code MeaningDescriptionData Model
200OKGet successfulInline

Response Data Structure

Marketing

GET Balance Recharge Gift Ratio

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

Balance recharge gift ratio

Response Example

200 Response

{
	"code": 0,
	"message": "Operation successful",
	"data": {
		"list": [null]
	}
}

Response Result

Status CodeStatus Code MeaningDescriptionData Model
200OKOKInline

Response Data Structure

Data Models

productTypes

9

Package type, 9 Dynamic Residential Traffic Package, 11 Dynamic Residential IP, 14 Static Datacenter IP, 25 Static Residential IP

Properties

NameTypeRequiredConstraintChinese NameDescription
anonymousintegerfalsenonePackage type, 9 Dynamic Residential Traffic Package, 11 Dynamic Residential IP, 14 Static Datacenter IP, 25 Static Residential IP

Enum Values

PropertyValue
anonymous9
anonymous11
anonymous14
anonymous25

apiKey

null

Authentication key

Properties

None

responseCode

200

Status code, 200 success, 3 app_key invalid

Properties

NameTypeRequiredConstraintChinese NameDescription
anonymousintegerfalsenoneStatus code, 200 success, 3 app_key invalid

responseMsg

"success"

response message

Properties

NameTypeRequiredConstraintChinese NameDescription
anonymousstringfalsenoneresponse message

SuccessResponse

{
	"code": 0,
	"message": "Operation successful",
	"data": {}
}

Properties

NameTypeRequiredConstraintChinese NameDescription
codeintegerfalsenonenone
messagestringfalsenonenone
dataobjectfalsenonenone

ErrorResponse

{
	"code": 400,
	"message": "Parameter error",
	"errors": {}
}

Properties

NameTypeRequiredConstraintChinese NameDescription
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

NameTypeRequiredConstraintChinese NameDescription
idintegerfalsenonenone
emailstring(email)falsenonenone
phonestringfalsenonenone
balancenumber(float)falsenonenone
statusintegerfalsenonenone
is_real_namebooleanfalsenonenone
created_atstring(date-time)falsenonenone

Order

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

Properties

NameTypeRequiredConstraintChinese NameDescription
idintegerfalsenonenone
trade_nostringfalsenonenone
product_idintegerfalsenonenone
product_namestringfalsenonenone
total_feenumber(float)falsenonenone
pay_feenumber(float)falsenonenone
statusintegerfalsenonenone
created_atstring(date-time)falsenonenone

Product

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

Properties

NameTypeRequiredConstraintChinese NameDescription
idintegerfalsenonenone
namestringfalsenonenone
typeintegerfalsenonenone
pricenumber(float)falsenonenone
descriptionstringfalsenonenone

WhiteIp

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

Properties

NameTypeRequiredConstraintChinese NameDescription
idintegerfalsenonenone
ipstringfalsenonenone
remarkstringfalsenonenone
created_atstring(date-time)falsenonenone

WhitelistAccount

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

Properties

NameTypeRequiredConstraintChinese NameDescription
idintegerfalsenonenone
usernamestringfalsenonenone
limitintegerfalsenonenone
usedintegerfalsenonenone
statusintegerfalsenonenone

Coupon

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

Properties

NameTypeRequiredConstraintChinese NameDescription
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

NameTypeRequiredConstraintChinese NameDescription
idintegerfalsenonenone
titlestringfalsenonenone
contentstringfalsenonenone
created_atstring(date-time)falsenonenone

Pagination

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

Properties

NameTypeRequiredConstraintChinese NameDescription
totalintegerfalsenonenone
page_nointegerfalsenonenone
page_sizeintegerfalsenonenone
total_pagesintegerfalsenonenone