API調用說明 v2023.12.01
請求
API請求路徑為： https://www.kookeey.com/
所有請求採用 HTTP GET 方式
請求固定包含accessid，signature和ts3個參數
單賬戶的請求頻率限制為 10 qps/s
https://kookeey.com/方法名?accessid=開發者ID&signature=參數字符串和時間戳的簽名值&ts=請求發起時間戳(秒)EXAMPLE:
https://kookeey.com/stock?accessid=1&signature=ZDQyNmExY2FiOWZhNDdiMjAzNTYyYmFhZDZmMWIyNzM4N2FjM2JmMA==&g=433&ts=1609430400
簽名
簽名方式：將所有的請求參數拼接完成後，通過開發者token計算出拼接完字符串的的HMAC-SHA1值，最後進行base64編碼
accessid：開發者ID，請從賬戶信息獲取
加密秘鑰：請從賬戶中心獲取
參數字符串：請查看每個接口的具體定義,
需要注意的是，加密的參數字符串的順序需要與URL的參數順序一致，例如，加密的參數字符串是：g=1&ts=1609430400；則URL是：/stock?accessid=1&signature=YzVkMjQxYjVmNjA2MWExMjAwYWYxMzUxM2I1YTY4YWYyOWIxMzA5NA==&g=1&ts=1609430400
說明：本文檔所有請求示例，均使用加密秘鑰1234567ABCDEFG進行加密，只是用作校驗您的簽名是否符合 API 的要求。 你向 API 發起請求時，請使用真實的數據
EXAMPLE:
JAVA:
Base64(HMAC-SHA1(加密秘鑰,UTF-8-Encoding-Of(參數字符串)))
PHP(>=5.1.2):
base64_encode(hash_hmac("sha1", 參數字符串, 加密秘鑰, false))
PYTHON(>=3.0):
base64.b64encode((hmac.new(bytes(加密秘鑰,encoding='utf-8'),bytes(參數字符串.strip('&'),encoding='utf-8'),hashlib.sha1).hexdigest()).encode("utf-8"))
響應
響應數據使用JSON格式
標準返回包含四個參數:success/data/msg/code
| 響應參數 | 類型 | 描述 |
|---|---|---|
| success | bool |
接口響應狀態，true表示成功,false表示失敗
|
| data | object | 具體結果數據 |
| msg | string | 結果說明 |
| code | int | 結果碼 |
結果碼
| 0 | 成功 |
| 10003 | 系統錯誤 |
| 10005 | 系統繁忙，暫不展示流量數據和生成動態端口，IP提取模式和已生成線路不受影響，請耐心等候 |
| 10006 | 參數錯誤 |
| 10015 | 簽名超時 |
| 10032 | 不支持的操作 |
| 10045 | 時間參數錯誤 |
| 10056 | 提交的備註信息過長 |
| 10059 | 簽名錯誤或超時 |
| 10061 | 數量範圍為1-99 |
| 10066 | 允許的操作數額為 1MB - 100TB |
| 10071 | 存在正在審核中的申請記錄,請勿重複提交! |
| 20001 | 數據狀態錯誤 |
| 20002 | 數據不存在 |
| 20003 | 數據已經存在 |
| 20004 | 用戶名已經存在 |
| 30030 | 超過訂單可以生成線路數量上限 |
| 30044 | 用戶狀態未激活，只能發送激活郵件 |
| 30051 | 所選地區UDP定制庫存不足 |
| 30052 | http協議不支持UDP定制 |
| 30054 | 該IP存在風險，不允許添加 |
| 30055 | IP驗證失敗，請在正確的IP環境下打開驗證鏈 |
| 30056 | 無可用白名單IP，需要先驗證白名單IP |
| 30063 | 請輸入6-16位數字字母(不分大小寫)的賬號 |
| 30064 | 請輸入8-24位數字字母(不分大小寫)的密碼 |
| 40001 | 身份驗證錯誤 |
| 40002 | 參數錯誤 |
| 40003 | 參數錯誤 |
| 40005 | 餘額不足，請充值或更換支付方式 |
| 40008 | 至少需要開啟一種安全策略 |
| 40009 | 無權執行該操作 |
| 40010 | 賬戶密碼認證已被關閉 |
| 40011 | 存在設置單獨的用戶名密碼的未過期線路 |
| 40012 | 動態流量餘額不足，請購買動態代理流量包 |
| 40013 | 超過可開啟獨立線路上限 |
| 40014 | 產品尚未開放自主購買 |
| 40015 | 非活動用戶，不可領取 |
| 40016 | 目標用戶不在代理名下 |
| 40017 | 超過可批量處理數據上限 |
| 40019 | IP 白名單不能為空 |
| 40022 | 動態線路無續費操作 |
| 40031 | 當前賬號有註銷記錄，請自註銷當日算起至30日後重新註冊 |
| 40033 | 已添加數據達到數量上限 |
| 40034 | 用戶ID和開發者Token不匹配 |
| 40035 | 該用戶已被其他賬戶綁為子賬號 |
| 40036 | 已達不活躍獨立端口上限，請先釋放無效端口 |
| 40041 | 移動代理流量餘額不足，請購買移動代理流量包 |
| 60001 | 請求過於頻繁 |
| 60005 | 請正確設置數值 |
| 70001 | 靜態數據中心不支持該業務，請選擇其他類型產品 |
| 70003 | 當前數據存在未完成的操作，請等10分鐘後操作 |
| 70004 | 無可用帶寬包 |
| 70005 | 國家/地區信息不匹配 |
| 70006 | 無可用GRE隧道，或適配GRE隧道的資源不足 |
| 80003 | 庫存不足 |
| 80004 | 訂單無效 |
| 80005 | 支付失敗 |
| 80006 | 端口正在配置中 |
| 80007 | 訂單正在支付中，請勿重複提交 |
| 80008 | 靜態端口不允許手動釋放 |
| 80010 | 無效的優惠券 |
| 80011 | 訂單金額未達到代金券優惠門檻 |
| 80012 | 優惠券不適用該訂單 |
| 80013 | 該優惠券已被其他訂單鎖定 |
