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
10006	Invalid parameters
10015	Signature timeout
10059	Invalid/expired signature
10061	Quantity must be 1-99
20001	Invalid data status
20002	Data not found
20003	Data already exists
20004	Username already exists
40001	Authentication error
40005	Insufficient balance
40008	At least one security policy required
40009	Unauthorized operation
40010	Account password authentication disabled
40011	Existing line with dedicated credentials
40012	Insufficient dynamic IP balance
40013	Exceeded dedicated line limit
40014	Product not available for self-purchase
40015	Inactive user
40016	Target user not under proxy
40017	Exceeded batch operation limit
60001	Request frequency too high
80003	Insufficient inventory
80004	Invalid order
80005	Payment failed
80006	Port in configuration
80007	Duplicate order submission
80008	Static port cannot be manually released