API Usage Instructions v2023.12.01
Request
API request path: https://kookeey.com/
All requests use HTTP GET method
Requests must include 3 parameters: accessid, signature, and
ts
Request frequency limit: 10 qps/s per account
https://kookeey.com/[method]?accessid=[developer_id]&signature=[signature_value]&ts=[request_timestamp]EXAMPLE:
https://kookeey.com/stock?accessid=1&signature=ZDQyNmExY2FiOWZhNDdiMjAzNTYyYmFhZDZmMWIyNzM4N2FjM2JmMA==&g=433&ts=1609430400
Signature
Signing method: Concatenate all request parameters, calculate HMAC-SHA1 using developer token, then perform base64 encoding
accessid: Developer ID (obtained from account information)
Encryption key: Obtained from account center
Parameter string: See specific interface definitions. Note that parameter order must match
URL parameter order (e.g., encrypted string: g=1&ts=1609430400)
Note: All examples use encryption key 1234567ABCDEFG for demonstration.
Use real data in production requests
EXAMPLE:
JAVA:
Base64(HMAC-SHA1(encryption_key,UTF-8-Encoding-Of(parameter_string)))
PHP(>=5.1.2):
base64_encode(hash_hmac("sha1", parameter_string, encryption_key, false))
PYTHON(>=3.0):
base64.b64encode((hmac.new(bytes(encryption_key,encoding='utf-8'),bytes(parameter_string.strip('&'),encoding='utf-8'),hashlib.sha1).hexdigest()).encode("utf-8"))
Response
Responses use JSON format
Standard response includes 4 parameters:
success/data/msg/code
| Parameter | Type | Description |
|---|---|---|
| success | bool | Request status: true = success,
false = failure
|
| data | object | Response data payload |
| msg | string | Status message |
| code | int | Result code |
Result Codes
| 0 | success |
| 10003 | System Data Error |
| 10005 | System Busy |
| 10006 | Param Error |
| 10015 | Signature Timeout |
| 10032 | Operation not support |
| 10045 | Wrong Time |
| 10056 | The remark information submitted is too long |
| 10059 | Signature error or timeout |
| 10061 | Amount must between 1 and 99 |
| 10066 | Avaliable amount is 1MB - 100TB |
| 10071 | Please do not submit your application again if it is already under review! |
| 20001 | Data Status Error |
| 20002 | Data Not Exist |
| 20003 | Data Already Exist |
| 20004 | Username Already Exist |
| 30030 | Reach maximum proxies a single order can placed |
| 30044 | User status is not activated, only activation email can be sent |
| 30051 | Selected GEO no available UDP stock |
| 30052 | UDP not available for http |
| 30054 | Risk IP,rejected by system |
| 30055 | Authentication Fail. Please open the IP Authentication Link under the correct IP |
| 30056 | No avaliable whitelist IP,need to auth your white IP first |
| 30063 | Please enter an account number of 6-16 digits (all case insensitive) |
| 30064 | Please enter an 8-24 alphanumeric (case insensitive) password |
| 40001 | Bad Auth |
| 40002 | Bad Param |
| 40003 | Param Error |
| 40005 | Insufficient Balance |
| 40008 | At Least One Security Rule Is Needed |
| 40009 | No Permission For This Action |
| 40010 | User/password auth is closed |
| 40011 | Exist Dedicated User/password Proxy |
| 40012 | No Enough Traffic |
| 40013 | No Enough Thread |
| 40014 | Product Not On Stock |
| 40015 | Not activity user |
| 40016 | User not belong to current agent |
| 40017 | Too many data |
| 40019 | IP whitelist cannot be empty |
| 40022 | Not allow to renew dynamic proxy |
| 40031 | The current account has a cancellation record. Please register again after 30 days |
| 40033 | Reach the quantity limit |
| 40034 | UserID and Developer-Token do not match |
| 40035 | This user has already been linked as a sub-account to another account |
| 40036 | Too many unactive Thread,please release unactive ports |
| 40041 | No Enough Traffic |
| 60001 | Frequently Request |
| 60005 | Please set up param value correctly |
| 70001 | Static Datacenter proxy cannot visit target website |
| 70003 | Exist not finish operation |
| 70004 | No avaliable Bandwidth Package |
| 70005 | Geo information not match |
| 70006 | No avaliable Gre Tunnel,or lack of avaliable resources |
| 80003 | No Stock |
| 80004 | No Order |
| 80005 | Pay Fail |
| 80006 | Proxy Under Config |
| 80007 | Repeat Submit,Your Order Is Under Paying |
| 80008 | Can not release static Proxy |
| 80010 | Invalid Coupon |
| 80011 | Order Amount Not Reach Coupon Threshol |
| 80012 | Coupon Not Avaliable For Current Order |
| 80013 | Coupon Locked By Other Order |
