This browser does not support JavaScript

Authentication account

Create sub user

Interface Address:https://api.okeyproxy.com/ipglobal-api/api/subAccount/add

Request Method:POST

Request Data Type:application/json

Response Data Type:*/*

Interface Description:Create a new sub user

Request Example:

{
  "authAccount": "",
  "authPassword": "",
  "ipType": 1,
  "remark": "",
  "useLimit": 0,
  "account": "xx123456@gmail.com",
  "token": "3ccpa01bxz5aed0de1uvenpzqaq78p"
}

Request Parameters:

Parameter Name Parameter Description Is It Necessary Type Of Data
authAccount Sub-account true string
authPassword Sub-account password true string
ipType Residential Proxies orders type(1-Starter 2-Advanced 3-Premium) true number
remark remark false string
useLimit useLimit true number
account Email or mobile number true string
token
Account token true string

Response Status:

Status Code Explanation
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found
7001 user name already exists, please change
7007 User account or Token is incorrect
7013 Request failed, please try again!
1038 The upper limit cannot exceed the remaining amount
1039 The upper limit cannot be less than the used traffi
1040 Sub-account flow limit is greater than 0

Response Parameter:

Not available yet

Response Example:

"success"

Update sub user

Interface Address:https://api.okeyproxy.com/ipglobal-api/api/subAccount/edit

Request Method:POST

Request Data Type:application/json

Response Data Type:*/*

Interface Description:Update password or traffic limit of specified sub user

Request Example:

{
  "authAccount": "",
  "authPassword": "",
  "account": "xx123456@gmail.com",
  "token": "3ccpa01bxz5aed0de1uvenpzqaq78p",
  "useLimit": 0,
  "remark": ""
}

Request Parameters:

Parameter Name Parameter Description Is It Necessary Type Of Data
authAccount Sub-account true string
authPassword Sub-account password false string
account Email or mobile number true string
token
Account token true string
useLimit Traffic usage limit (G) false number(double)
remark Remark false string

Response Status:

Status Code Explanation
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found
7003 The upper limit of traffic is greater than -1
7004 illegal request
7007 User account or Token is incorrect!
7013 Request failed, please try again!
1038 The upper limit cannot exceed the remaining amount
1039 The upper limit cannot be less than the used traffi
1040 Sub-account flow limit is greater than 0

Response Parameter:

Not available yet

Response Example:

"success"

Delete sub user

Interface Address:https://api.okeyproxy.com/ipglobal-api/api/subAccount/delete

Request Method:POST

Request Data Type:application/json

Response Data Type:*/*

Interface Description:Delete specified sub user

Request Example:

{
  "authAccount": "",
  "account": "xx123456@gmail.com",
  "token": "3ccpa01bxz5aed0de1uvenpzqaq78p"
}

Request Parameters:

Parameter Name Parameter Description Is It Necessary Type Of Data
authAccount Sub-account true string
account Email or mobile number true string
token
Account token true string

Response Status:

Status Code Explanation
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found
7004 illegal request
7005 The main account cannot be deleted!
7007 User account or Token is incorrect!
7013 Request failed, please try again!

Response Parameter:

Not available yet

Response Example:

"success"

White List

Add whitelisted IPs

Interface Address:https://api.okeyproxy.com/ipglobal-api/api/ipWhite/add

Request Method:POST

Request Data Type:application/json

Response Data Type:*/*

Interface Description:Whitelist your IPs here (When allSuccess is true, all IPs are added successfully, allSuccess part is added successfully, repeatIpSelf: own repeat IP, repeatIpOther: repeat IP belonging to others)

Request Example:

{
  "clientIpSet": [],
  "account": "xx123456@gmail.com",
  "remark": "",
  "token": "3ccpa01bxz5aed0de1uvenpzqaq78p"
}

Request Parameters:

Parameter Name Parameter Description Is It Necessary Type Of Data
clientIpSet ip true array
account Email or mobile number true string
remark Remark false string
token
Account token true string

Response Status:

Status Code Explanation
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found
7006 wrong ip format!
7007 User account or Token is incorrect!
7013 Request failed, please try again!

Response Parameter:

Parameter Name Parameter Description Type
allSuccess Whether all the additions are successful boolean
repeatIpOther Duplicate IPs belong to someone else array
repeatIpSelf Duplicate IP belongs to own array

Response Example:

{
  "allSuccess": true,
  "repeatIpOther": [],
  "repeatIpSelf": []
}

Get whitelisted IPs

Interface Address:https://api.okeyproxy.com/ipglobal-api/api/ipWhite/page

Request Method:POST

Request Data Type:application/json

Response Data Type:*/*

Interface Description:Get a list of whitelisted IPs

Request Example:

{
  "account": "xx123456@gmail.com",
  "pageParam": {
    "currentPage": 0,
    "pageSize": 10,
    "param": {
      "clientIp": ""
    }
  },
  "token": "3ccpa01bxz5aed0de1uvenpzqaq78p"
}

Request Parameters:

Parameter Name Parameter Description Is It Necessary Type Of Data
account Email or mobile number true string
pageParam Pagination Parameters false json
  currentPage Current page true integer
  pageSize Page size true integer
  param Parameter false json
    clientIp ip false string
token
Account token true string

Response Status:

Status Code Explanation
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found
7007 User account or Token is incorrect!
7013 Request failed, please try again!

Response Parameter:

Parameter Name Parameter Description Type
currentPage Current page integer
data Data array
  addTime add time string
  clientIp ip address string
  id primary key id string
  remark Remark string
pageSize Page size integer
totalCount Total count integer
totalPage Total page integer

Response Example:

{
  "currentPage": 0,
  "data": [
    {
      "addTime": "",
      "clientIp": "",
      "id": "",
      "remark": ""
    }
  ],
  "pageSize": 0,
  "totalCount": 0,
  "totalPage": 0
}

Delete whitelisted IP

Interface Address:https://api.okeyproxy.com/ipglobal-api/api/ipWhite/delete

Request Method:POST

Request Data Type:application/json

Response Data Type:*/*

Interface Description:Delete a specified whitelisted IP

Request Example:

{
  "clientIpSet": [],
  "account": "xx123456@gmail.com",
  "token": "3ccpa01bxz5aed0de1uvenpzqaq78p"
}

Request Parameters:

Parameter Name Parameter Description Is It Necessary Type Of Data
clientIpSet ip true array
account Email or mobile number true string
token
Account token true string

Response Status:

Status Code Explanation
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found
7006 wrong ip format!
7007 User account or Token is incorrect!
7013 Request failed, please try again!

Response Parameter:

Not available yet

Response Example:

boolean

Traffic Query

User account traffic

Interface Address:https://api.okeyproxy.com/ipglobal-api/api/staticMeal/trafficInformation

Request Method:POST

Request Data Type:application/json

Response Data Type:*/*

Interface Description:Total traffic of user package, used, remaining available

Request Example:

{
  "account": "xx123456@gmail.com",
  "token": "3ccpa01bxz5aed0de1uvenpzqaq78p"
}

Request Parameters:

Parameter Name Parameter Description Is It Necessary Type Of Data
account Email or mobile number true string
token
Account token true string

Response Status:

Status Code Explanation
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found
7007 User account or Token is incorrect!
7013 Request failed, please try again!

Response Parameter:

Parameter Name Parameter Description Type
autoFlowRenewStatus Traffic recharge status(0-On 1-Off) integer
autoRenewStatus auto-renewal status(0-On 1-Off) integer
beginTime Starting time string
cfpId traffic packet id string
customerMealNum Customer package number string
endTime stop the time string
mealName Package name string
mealNum Package number integer
mealTraffic The total flow of the first purchase G string
nextTime next renewal time string
payment Package amount number
showTotalFlow Total flow G string
showUseFlow Used traffic G string
totalFlow Total flow M number
useFlow Used flow M number
ipType Residential Proxies orders type(1-Starter 2-Advanced 3-Premium) number
webCustomerFlowAddVOList array
  payment amount string
  showTraffic show traffic string
  state Order Status(1-To be paid 2-Paid 3-Cancelled 4-Withdrawal successful) integer

Response Example:

[
  {
    "autoFlowRenewStatus": 0,
    "autoRenewStatus": 0,
    "beginTime": "",
    "cfpId": "",
    "customerMealNum": "",
    "endTime": "",
    "mealName": "",
    "mealNum": 0,
    "mealTraffic": "",
    "nextTime": "",
    "payment": 0,
    "showTotalFlow": "",
    "showUseFlow": "",
    "totalFlow": 0,
    "useFlow": 0,
    "ipType": 1,
    "webCustomerFlowAddVOList": [
      {
        "payment": "",
        "showTraffic": "",
        "state": 0
      }
    ]
  }
]

Certified Account Traffic

Interface Address:https://api.okeyproxy.com/ipglobal-api/api/certified/traffic

Request Method:POST

Request Data Type:application/json

Response Data Type:*/*

Interface Description:Authentication account traffic information

Request Example:

{
  "account": "xx123456@gmail.com",
  "token": "3ccpa01bxz5aed0de1uvenpzqaq78p",
  "pageParam": {
    "currentPage": 0,
    "pageSize": 10,
    "param": {
      "authAccount": ""
    }
  }
}

Request Parameters:

Parameter Name Parameter Description Is It Necessary Type Of Data
account Email or mobile number true string
token
Account token true string
pageParam Pagination Parameters false json
  currentPage Current page true integer
  pageSize Page size true integer
  param Parameter false json
    authAccount Username false string

Response Status:

Status Code Explanation
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found
7007 User account or Token is incorrect!
7013 Request failed, please try again!

Response Parameter:

Parameter Name Parameter Description Type
currentPage Current page integer
data Data array
  authAccount Sub-account string
  authPassword Sub-account password string
  mainFlag Is it the main account boolean
  useFlow Traffic used: G number(double)
  useLimit Data usage limit: G number(double)
  ipType Residential Proxies orders type(1-Starter 2-Advanced 3-Premium) number
pageSize Page size integer
totalCount Total count integer
totalPage Total page integer

Response Example:

{
  "currentPage": 0,
  "data": [
    {
      "authAccount": "",
      "authPassword": "",
      "mainFlag": true,
      "useFlow": 0,
      "useLimit": 0,
      "ipType": 1
    }
  ],
  "pageSize": 10,
  "totalCount": 0,
  "totalPage": 0
}

Authentication account traffic usage

Interface Address:https://api.okeyproxy.com/ipglobal-api/api/useInfo

Request Method:POST

Request Data Type:application/json

Response Data Type:*/*

Interface Description:Authentication account traffic usage records

Request Example:

{
  "authAccounts": ["xxxxxxxx12"],
  "account": "xx123456@gmail.com",
  "token": "3ccpa01bxz5aed0de1uvenpzqaq78p",
  "useEndTime": 1666713600000,
  "useStartTime": 1665504000000
}

Request Parameters:

Parameter Name Parameter Description Is It Necessary Type Of Data
authAccounts User sub-account username false array
account Email or mobile number true string
token
Account token true string
useEndTime Use end time (timestamp at 00:00:00 of the day)) false string
useStartTime Use start time (timestamp of the day at 00:00:00) false string

Response Status:

Status Code Explanation
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found
7008 User information is abnormal!
7013 Request failed, please try again!

Response Parameter:

Parameter Name Parameter Description Type
list usage record array
  flow Use flow (M) string
  useTime usage time(timestamp at 00:00:00 of the day)) string
total Total traffic usage (G) string

Response Example:

{
  "list": [
    {
      "flow": "",
      "useTime": ""
    }
  ],
  "total": ""
}

IP Query

Static residential (ISP) IP list

Interface Address:https://api.okeyproxy.com/ipglobal-api/api/ispIpList

Request Method:POST

Request Data Type:application/json

Response Data Type:*/*

Interface Description:Static Residential (ISP) IP Information

Request Example:

{
  "customerMealNum": 20221026092733022,
  "account": "xx123456@gmail.com",
  "token": "3ccpa01bxz5aed0de1uvenpzqaq78p"
}

Request Parameters:

Parameter Name Parameter Description Is It Necessary Type Of Data
customerMealNum Customer package number true string
account Email or mobile number true string
token
Account token true string

Response Status:

Status Code Explanation
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found
7007 User account or Token is incorrect!
7013 Request failed, please try again!

Response Parameter:

Parameter Name Parameter Description Type
account account string
cbiId customer purchase allocation ip record id string
ip ip address string
password password string
port port string
ipKind ip attribute(1-Standard ISP 2-Premium ISP) integer

Response Example:

[
  {
    "account": "fg89fg5g",
    "cbiId": 1585080658883244034,
    "ip": "10.10.73.3",
    "password": "dx154sg9",
    "port": 40010,
    "ipKind": 1
  }
]

Datacenter IP List

Interface Address:https://api.okeyproxy.com/ipglobal-api/api/datIpList

Request Method:POST

Request Data Type:application/json

Response Data Type:*/*

Interface Description:Datacenter IP Information

Request Example:

{
  "customerMealNum": 20221026092733022,
  "account": "xx123456@gmail.com",
  "token": "3ccpa01bxz5aed0de1uvenpzqaq78p"
}

Request Parameters:

Parameter Name Parameter Description Is It Necessary Type Of Data
customerMealNum Customer package number true string
account Email or mobile number true string
token
Account token true string

Response Status:

Status Code Explanation
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found
7007 User account or Token is incorrect!
7013 Request failed, please try again!

Response Parameter:

Parameter Name Parameter Description Type
account account string
cbiId customer purchase allocation ip record id string
ip ip address string
password password string
port port string

Response Example:

[
  {
    "account": "fg89fg5g",
    "cbiId": 1585080658883244034,
    "ip": "10.10.73.3",
    "password": "dx154sg9",
    "port": 40010
  }
]

Automatic Renewal

Residential extension

Interface Address:https://api.okeyproxy.com/ipglobal-api/api/checkBalance

Request Method:POST

Request Data Type:application/json

Response Data Type:*/*

Interface Description:Increased traffic after renewal of dynamic residential package and increased package usage time

Request Example:

{
  "customerMealNum": 20221026092733022,
  "account": "xx123456@gmail.com",
  "token": "3ccpa01bxz5aed0de1uvenpzqaq78p"
}

Request Parameters:

Parameter Name Parameter Description Is It Necessary Type Of Data
customerMealNum Customer package number true string
account Email or mobile number true string
token
Account token true string

Response Status:

Status Code Explanation
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found
7004 illegal request
7007 User account or Token is incorrect!
7008 User information is abnormal!
7009 Order does not exist!
7010 Package does not exist!
7011 Package is disabled!
7012 Insufficient balance!
7013 Request failed, please try again!
7014 This package type cannot be renewed!

Response Parameter:

Not available yet

Response Example:

true

Traffic recharge

Interface Address:https://api.okeyproxy.com/ipglobal-api/api/addFlow

Request Method:POST

Request Data Type:application/json

Response Data Type:*/*

Interface Description:Dynamic residential package traffic recharge

Request Example:

{
  "buyFlow": 10,
  "customerMealNum": 20221012103411116,
  "account": "xx123456@gmail.com",
  "token": "3ccpa01bxz5aed0de1uvenpzqaq78p"
}

Request Parameters:

Parameter Name Parameter Description Is It Necessary Type Of Data
buyFlow Purchase traffic G true string
customerMealNum Customer package number true string
account Email or mobile number true string
token
Account token true string

Response Status:

Status Code Explanation
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found
7004 illegal request
7007 User account or Token is incorrect!
7010 Package does not exist!
7013 Request failed, please try again!
7015 This package type cannot be recharged!

Response Parameter:

Not available yet

Response Example:

true

Renew by IP

Renew by IP

Interface Address:https://api.okeyproxy.com/ipglobal-api/api/renew/ip

Request Method:POST

Request Data Type:application/json

Response Data Type:*/*

Interface Description:After purchasing a static residential ISP or data center package, choose IP renewal within the package.

Request Example:

{
  "account": xx123456@gmail.com,
  "ips": ["10.10.73.3", "10.10.73.4"],
  "mealId": 96,
  "token": "3ccpa01bxz5aed0de1uvenpzqaq78p"
}

Request Parameters:

Parameter Name Parameter Description Is It Necessary Type Of Data
account Email or mobile number true string
ips Renewal IP list true array
mealId Package ID true string
token
Account token true integer

Package ID:

Package Type Package ID Duration(Days) Price($)
Static 95 7 2.5
Static 98 30 5
Static 100 90 15
Data Center 101 7 2
Data Center 103 30 4
Data Center 104 90 12

Response Status:

Status Code Explanation
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found
7004 illegal request
7007 User account or Token is incorrect!
7008 User information is abnormal!
7009 Order does not exist!
7010 Package does not exist!
7011 Package is disabled!
7012 Insufficient balance!
7013 Request failed, please try again!
7014 This package type cannot be renewed!

Response Parameter:

Not available yet

Response Example:

true

Get orders

Get Residential Proxies orders

Interface Address:https://api.okeyproxy.com/ipglobal-api/api/queryMain

Request Method:POST

Request Data Type:application/json

Response Data Type:*/*

Interface Description:Residential Proxies orders Information

Request Example:

{
  "account": "xx123456@gmail.com",
  "token": "3ccpa01bxz5aed0de1uvenpzqaq78p",
  "pageParam": {
    "currentPage": 0,
    "pageSize": 10,
    "param": {
      "mealType": "1"
    }
  }
}

Request Parameters:

Parameter Name Parameter Description Is It Necessary Type Of Data
account Email or mobile number true string
token
Account token true string
pageParam Pagination query parameters true json
  currentPage Current page true integer
  pageSize Page size true integer
  param Parameter true json
    mealType Package Type(1-Dynamic Residential) true integer

Response Status:

Status Code Explanation
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found
7007 User account or Token is incorrect!
7013 Request failed, please try again!

Response Parameter:

Parameter Name Parameter Description Type
currentPage Current page integer
data Data array
  customerMealNum Customer package number string
  mealOrderId primary key id string
  orderTime order time(timestamp) string
  orderType Order Type integer
  ipType Residential Proxies orders type(1-Starter 2-Advanced 3-Premium) number
  payTime Payment time(timestamp) string
  payment Actually paid string
  state Order Status integer
pageSize Page size integer
totalCount Total count integer
totalPage Total page integer

Response Example:

{
  "currentPage": 0,
  "data": [
    {
      "customerMealNum": "20221025102345424",
      "mealOrderId": "1584732415862390786",
      "orderTime": "1666664625423",
      "orderType": "1",
      "ipType": 1,
      "payTime": "1666664671413",
      "payment": "100.00",
      "state": "1"
    }
  ],
  "pageSize": 10,
  "totalCount": 0,
  "totalPage": 0
}

Get Static Residential Proxies (ISP) orders

Interface Address:https://api.okeyproxy.com/ipglobal-api/api/queryMain

Request Method:POST

Request Data Type:application/json

Response Data Type:*/*

Interface Description:Static Residential Proxies (ISP) orders Information

Request Example:

{
  "account": "xx123456@gmail.com",
  "token": "3ccpa01bxz5aed0de1uvenpzqaq78p",
  "pageParam": {
    "currentPage": 0,
    "pageSize": 10,
    "param": {
      "mealType": "2"
    }
  }
}

Request Parameters:

Parameter Name Parameter Description Is It Necessary Type Of Data
account Email or mobile number true string
token
Account token true string
pageParam Pagination query parameters true json
  currentPage Current page true integer
  pageSize Page size true integer
  param Parameter true json
    mealType Package Type(2-Static ISP Residential) true integer

Response Status:

Status Code Explanation
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found
7007 User account or Token is incorrect!
7013 Request failed, please try again!

Response Parameter:

Parameter Name Parameter Description Type
currentPage Current page integer
data Data array
  mealOrderId primary key id string
  orderTime order time(timestamp) string
  orderType Order Type integer
  payTime Payment time(timestamp) string
  payment Actually paid string
  state Order Status integer
pageSize Page size integer
totalCount Total count integer
totalPage Total page integer

Response Example:

{
  "currentPage": 0,
  "data": [
    {
      "mealOrderId": "1584732415862390786",
      "orderTime": "1666664625423",
      "orderType": "1",
      "payTime": "1666664671413",
      "payment": "100.00",
      "state": "1"
    }
  ],
  "pageSize": 10,
  "totalCount": 0,
  "totalPage": 0
}

Get Datacenter Proxies orders

Interface Address:https://api.okeyproxy.com/ipglobal-api/api/queryMain

Request Method:POST

Request Data Type:application/json

Response Data Type:*/*

Interface Description:Datacenter Proxies orders Information

Request Example:

{
  "account": "xx123456@gmail.com",
  "token": "3ccpa01bxz5aed0de1uvenpzqaq78p",
  "pageParam": {
    "currentPage": 0,
    "pageSize": 10,
    "param": {
      "mealType": "3"
    }
  }
}

Request Parameters:

Parameter Name Parameter Description Is It Necessary Type Of Data
account Email or mobile number true string
token
Account token true string
pageParam Pagination query parameters true json
  currentPage Current page true integer
  pageSize Page size true integer
  param Parameter true json
    mealType Package Type(3-Data Center) true integer

Response Status:

Status Code Explanation
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found
7007 User account or Token is incorrect!
7013 Request failed, please try again!

Response Parameter:

Parameter Name Parameter Description Type
currentPage Current page integer
data Data array
  mealOrderId primary key id string
  orderTime order time(timestamp) string
  orderType Order Type integer
  payTime Payment time(timestamp) string
  payment Actually paid string
  state Order Status integer
pageSize Page size integer
totalCount Total count integer
totalPage Total page integer

Response Example:

{
  "currentPage": 0,
  "data": [
    {
      "mealOrderId": "1584732415862390786",
      "orderTime": "1666664625423",
      "orderType": "1",
      "payTime": "1666664671413",
      "payment": "100.00",
      "state": "1"
    }
  ],
  "pageSize": 10,
  "totalCount": 0,
  "totalPage": 0
}