Residential Proxies

Operations for residential proxies

Purchase additional traffic (Residential)

post

授权

Authorizationstring必填

Bearer authentication header of the form Bearer <token>.

路径参数

idinteger必填

请求体

amountinteger必填

Amount in GB

Example: 5

promo_codestring · 可为 null可选

响应

200

Success

application/json

successboolean必填

post/user/api/orders/{id}/add-bandwidth

POST /user/api/orders/{id}/add-bandwidth HTTP/1.1
Host: user-api.proxyshard.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 32

{
  "amount": 5,
  "promo_code": "text"
}

200

Success

{
  "success": true
}

Parent (account owner) traffic

get

Returns the parent account's own total and remaining data for the given proxy type, aggregated across the parent's orders. Unlike the sub-user endpoints, this reflects the data of the account owner, not a sub-user.

授权

Authorizationstring必填

Bearer authentication header of the form Bearer <token>.

查询参数

proxy_typestring必填

Proxy type (standart | premium)

Example: standart

响应

200

Success

application/json

successboolean必填

datainteger必填

Total allocated data in bytes

data_remaininteger必填

Remaining data in bytes

data_spentinteger必填

Consumed data in bytes

400

User resident not set / invalid proxy type

application/json

401

Unauthorized

application/json

get/user/api/proxies/profile

GET /user/api/proxies/profile?proxy_type=standart HTTP/1.1
Host: user-api.proxyshard.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "data": 1,
  "data_remain": 1,
  "data_spent": 1
}

Sub-user list

get

授权

Authorizationstring必填

Bearer authentication header of the form Bearer <token>.

查询参数

proxy_typestring必填

Proxy type (standart | premium)

Example: standart

offsetinteger可选Example: 0

limitinteger可选Example: 20

响应

200

Success

application/json

successboolean可选

get/user/api/proxies/sub-users

GET /user/api/proxies/sub-users?proxy_type=standart HTTP/1.1
Host: user-api.proxyshard.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Success

{
  "success": true,
  "data": [
    {
      "user_id": "text",
      "first_name": "text",
      "proxy_password": "text",
      "data": 1,
      "data_spent": 1,
      "data_remain": 1
    }
  ]
}

Get sub-user by ID

get

授权

Authorizationstring必填

Bearer authentication header of the form Bearer <token>.

路径参数

user_idstring必填

查询参数

proxy_typestring必填

Proxy type (standart | premium)

Example: standart

响应

200

Success

application/json

successboolean可选

get/user/api/proxies/sub-user/{user_id}

GET /user/api/proxies/sub-user/{user_id}?proxy_type=standart HTTP/1.1
Host: user-api.proxyshard.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Success

{
  "success": true,
  "data": [
    {
      "first_name": "text",
      "proxy_password": "text",
      "data": 1,
      "data_spent": 1
    }
  ]
}

Delete sub-user

delete

授权

Authorizationstring必填

Bearer authentication header of the form Bearer <token>.

路径参数

user_idstring必填

响应

200

Success

application/json

successboolean可选

dataobject可选

delete/user/api/proxies/sub-user/{user_id}

DELETE /user/api/proxies/sub-user/{user_id} HTTP/1.1
Host: user-api.proxyshard.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Success

{
  "success": true,
  "data": {}
}

Edit sub-user (name/package)

patch

授权

Authorizationstring必填

Bearer authentication header of the form Bearer <token>.

路径参数

user_idstring必填

查询参数

proxy_typestring必填

Proxy type (standart | premium)

Example: standart

请求体

namestring必填

响应

200

Success

application/json

successboolean可选

dataobject可选

patch/user/api/proxies/sub-user/{user_id}

PATCH /user/api/proxies/sub-user/{user_id}?proxy_type=standart HTTP/1.1
Host: user-api.proxyshard.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "name": "text"
}

200

Success

{
  "success": true,
  "data": {}
}

Create sub-user

post

授权

Authorizationstring必填

Bearer authentication header of the form Bearer <token>.

查询参数

proxy_typestring必填

Proxy type (standart | premium)

Example: standart

请求体

namestring必填

datainteger必填

响应

200

Success

application/json

successboolean可选

post/user/api/proxies/sub-user

POST /user/api/proxies/sub-user?proxy_type=standart HTTP/1.1
Host: user-api.proxyshard.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "name": "text",
  "data": 1
}

200

Success

{
  "success": true,
  "data": [
    {
      "user_id": "text",
      "first_name": "text",
      "proxy_password": "text",
      "data": 1,
      "data_spent": 1
    }
  ]
}

Add traffic to sub-user

post

授权

Authorizationstring必填

Bearer authentication header of the form Bearer <token>.

路径参数

user_idstring必填

查询参数

proxy_typestring必填

Proxy type (standart | premium)

Example: standart

请求体

datainteger必填

Amount in GB

Example: 5

响应

200

Success

application/json

successboolean可选

dataobject可选

post/user/api/proxies/sub-user/{user_id}/data/add

POST /user/api/proxies/sub-user/{user_id}/data/add?proxy_type=standart HTTP/1.1
Host: user-api.proxyshard.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 10

{
  "data": 5
}

200

Success

{
  "success": true,
  "data": {}
}

Subtract traffic from sub-user

post

授权

Authorizationstring必填

Bearer authentication header of the form Bearer <token>.

路径参数

user_idstring必填

查询参数

proxy_typestring必填

Proxy type (standart | premium)

Example: standart

请求体

datainteger必填

Amount in GB

Example: 5

响应

200

Success

application/json

successboolean可选

dataobject可选

post/user/api/proxies/sub-user/{user_id}/data/subtract

POST /user/api/proxies/sub-user/{user_id}/data/subtract?proxy_type=standart HTTP/1.1
Host: user-api.proxyshard.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 10

{
  "data": 5
}

200

Success

{
  "success": true,
  "data": {}
}

Change sub-user password

post

授权

Authorizationstring必填

Bearer authentication header of the form Bearer <token>.

路径参数

user_idstring必填

查询参数

proxy_typestring必填

Proxy type (standart | premium)

Example: standart

响应

200

Success

application/json

successboolean可选

dataobject可选

post/user/api/proxies/sub-user/{user_id}/password

POST /user/api/proxies/sub-user/{user_id}/password?proxy_type=standart HTTP/1.1
Host: user-api.proxyshard.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Success

{
  "success": true,
  "data": {}
}

Country list

get

授权

Authorizationstring必填

Bearer authentication header of the form Bearer <token>.

查询参数

proxy_typestring必填

Proxy type (standart | premium)

Example: standart

响应

200

Success

application/json

countinteger必填

get/user/api/proxies/countries

GET /user/api/proxies/countries?proxy_type=standart HTTP/1.1
Host: user-api.proxyshard.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Success

{
  "count": 1,
  "results": [
    {
      "code": "text",
      "name": "text"
    }
  ]
}

Region list

get

授权

Authorizationstring必填

Bearer authentication header of the form Bearer <token>.

查询参数

proxy_typestring必填

Proxy type (standart | premium)

Example: standart

country_codestring必填

ISO country code

Example: DE

响应

200

Success

application/json

countinteger必填

get/user/api/proxies/regions

GET /user/api/proxies/regions?proxy_type=standart&country_code=DE HTTP/1.1
Host: user-api.proxyshard.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Success

{
  "count": 1,
  "results": [
    {
      "code": "text",
      "name": "text",
      "country": {
        "code": "text",
        "name": "text"
      }
    }
  ]
}

City list

get

授权

Authorizationstring必填

Bearer authentication header of the form Bearer <token>.

查询参数

proxy_typestring必填

Proxy type (standart | premium)

Example: standart

country_codestring必填

ISO country code

Example: DE

region_codestring必填

Region code (state/province code)

Example: BE

响应

200

Success

application/json

countinteger必填

get/user/api/proxies/cities

GET /user/api/proxies/cities?proxy_type=standart&country_code=DE&region_code=BE HTTP/1.1
Host: user-api.proxyshard.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Success

{
  "count": 1,
  "results": [
    {
      "code": "text",
      "name": "text",
      "country": {
        "code": "text",
        "name": "text"
      },
      "region": {
        "code": "text",
        "name": "text"
      }
    }
  ]
}

上一页Datacenter & ISP Proxies 下一页General

最后更新于 2个月前

这有帮助吗？