SmartProxy OpenAPI DocSmartProxy OpenAPI Doc
  • English
  • zh-CN
  • English
  • zh-CN
  • Authentication Method
  • Response Format
  • Proxy Account
  • Traffic Log
  • Product Query
  • IP Extract
  • Order Management
  • User Management
  • Payment Management
  • Marketing/Activity

Proxy Account List

GET

/pub/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 invalid app_key
» 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 Datacenter IP, 25 Static Residential IP
»»» usage_flowintegerfalsenoneTraffic used, unit: KB
»»» limit_flowintegerfalsenoneCustom traffic limit: unit GB, maximum 102400, 0 for unlimited
»»» statusintegerfalsenoneStatus: 1 enabled, 0 disabled

Enumeration Values

PropertyValue
product_type9
product_type11
product_type14
product_type25

Add Proxy Account

POST

/pub/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 and password, please fill in the format username:password. Username and password only support numbers and letters, no special symbols or spaces allowed. Colon separates username and password. Supports batch addition, separated by commas (,).
» remarkbodystringNoProxy account description
» product_typebodyproductTypesNoPackage type: 9 Dynamic Residential Traffic Package, 11 Dynamic Residential IP, 14 Static Datacenter IP, 25 Static Residential IP

Enumeration 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 invalid app_key, 156 account not verified
» msgstringfalsenoneStatus message
» datanullfalsenonenone

Delete Proxy Account

POST

/pub/whitelist-account/delete

Please note that deletion is irreversible, and used traffic records cannot be queried. Deletion has a waiting time of about 5 minutes, during which charges may still occur.

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 operations, separated by commas (,)

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 invalid app_key, 156 account not verified
» msgstringfalsenoneStatus message
» datanullfalsenonenone

Disable Proxy Account

POST

/pub/whitelist-account/disable

Disabling has a waiting time of about 5 minutes, during which charges may still occur.

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 operations, separated by commas (,)

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 invalid app_key, 156 account not verified
» msgstringfalsenoneStatus message
» datanullfalsenonenone

Enable Proxy Account

POST

/pub/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 operations, separated by commas (,)

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 invalid app_key, 156 account not verified
» msgstringfalsenoneStatus message
» datanullfalsenonenone

Change Proxy Account Password

POST

/pub/whitelist-account/change-password

Please note that after changing the password, there is a waiting time of 5 minutes, 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 invalid app_key, 156 account not verified
» msgstringfalsenoneStatus message
» datanullfalsenonenone

Change Proxy Account Remark

POST

/pub/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 invalid app_key, 156 account not verified
» msgstringfalsenoneStatus message
» datanullfalsenonenone

Change Proxy Account Traffic Limit

POST

/pub/whitelist-account/change-limit

Please note that traffic statistics may have a delay within 5 minutes, meaning actual traffic consumed 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 invalid app_key, 156 account not verified
» msgstringfalsenoneStatus message
» datanullfalsenonenone
Prev
Response Format
Next
Traffic Log