接口地址: https://登錄后顯示/api/140/286(支持:http/https)
返回格式:json,xml
請求方式:GET,POST
POST 請求需要設置Header頭:Content-Type: application/x-www-form-urlencoded;charset=utf-8
Api測試工具請求說明:
名稱 | 必填 | 類型 | 說明 | 示例 參數另存 |
---|---|---|---|---|
appid | 是 | String | 應用ID,在后臺我的應用查看或者添加 | 1 |
debug | 否 | String | 調試參數,當此值為1時,返回的為虛擬調試數據。使用接口對接完成之后請去掉些參數即可 | 1 |
format | 否 | String | 返回數據格式類型,每個接口已經說明支持返回格式:json,xml | json |
notify_url | 否 | String | 回調地址,當查詢有結果時,通過這個地址獎結果返回。沒有填寫正確的地址不會有結果返回 查看回調參數文檔 | http://www.donkazak.com/notify_url |
qq_number | 否 | String | 充值的QQ號碼 | 1009283 |
sign | 是 | String | 參數按一定規則md5后返回的字符串,詳情點擊這里閱讀 | 52a32be274a5c537bbf7a53e2d66c09f |
加密順序
返回參數說明:
JSON返回示例:
服務器狀態碼:
狀態碼 | 說明 |
---|---|
10000 | 返回成功 |
10001 | appid必須指定,可以我的應用里面查看 |
10002 | sign值必須指定,加密規則請前往幫助中心查看 |
10003 | sign值驗證不通過,加密規則請前往幫助中心查看 |
10004 | 時差不能超過10分鐘,可以不傳遞這個參數,注意時間戳單位是秒 |
10005 | appid錯誤,請檢查appid值,前往會員中心->我的應用查看或添加 |
10006 | 當前IP地址未授權,請前往用戶中心->我的應用添加ip{@info} |
10007 | 應用被禁用,請聯系客服處理 |
10008 | 應用內沒有該接口,請到我的應用里面添加這個接口 |
10009 | api接口不存在 |
10010 | 您沒有訂購該api |
10011 | api已經到期 |
10012 | 沒有訂購任何api,請前往購買后再操作 |
10013 | 該接口已經暫停使用 |
10014 | 未知的錯誤,可以聯系客服處理 |
10015 | 參數個數錯誤 |
10019 | {@info} |
10017 | time必須是整型 |
10018 | 次數不足 |
10020 | 子接口不存在,可能已經被關閉 |
10021 | 服務器發生錯誤 |
10022 | 帳戶余額不足,請充值! |
請選擇開發語言:
$api_url = 'https://登錄后顯示/api/140/286'; $appid = '應用id';// 在后臺我的應用查看; $secret = '應用密鑰';// 在后臺我的應用查看; $data = array( 'appid'=> '1', 'debug'=> '1', 'format'=> 'json', 'notify_url'=> 'http://www.donkazak.com/notify_url', 'qq_number'=> '1009283', ); $data['appid'] = $appid; $data['time'] = time();//當前服務器時間 ksort($data); //按照鍵名對數組排序,為數組值保留原來的鍵。 $md5String = ''; foreach($data as $key=>$val){ if(strlen($val)>0){ //過濾空值 $md5String.=$key.$val; } } $sign = md5($md5String.$secret); $data['sign'] = $sign; $sendUrl = $api_url.'?'.http_build_query($data); //把數據轉換成url參數形式,a=b&c=d&e=f $result = file_get_contents($sendUrl); print_r($result);
#!/usr/bin/python3 # -*- coding: UTF-8 -*- #該代碼為python3.7示例代碼 import ssl,time,hashlib,string from urllib import request,parse,error; from urllib.parse import quote api_url = 'https://登錄后顯示/api/140/286'; appid = '應用id';#在后臺我的應用查看; secret = '應用密鑰';#在后臺我的應用查看; data = { 'appid':'1', 'debug':'1', 'format':'json', 'notify_url':'http://www.donkazak.com/notify_url', 'qq_number':'1009283', }; data['appid'] = appid; data['time'] = round(time.time());#當前服務器時間 keysArr = list(data.keys()) #取出字典key keysArr.sort()#對字典key進行排序 md5String = ''; params = [] for key in keysArr: if data[key]: val = str(data[key]) md5String+=key+val params.append(key + "=" + val ) md5String += secret; m = hashlib.md5() b = md5String.encode(encoding='utf-8') m.update(b) sign = m.hexdigest() params.append('sign='+sign)#加入計算后的sign值去請求 params = '&'.join(tuple(params)); #把列表轉成元組后用&分隔,最終轉換成字符串 a=b&c=d&e=f ssl._create_default_https_context = ssl._create_unverified_context url = api_url+'?'+params; url = quote(url, safe=string.printable) req = request.Request(url) opener = request.build_opener() r = opener.open(fullurl=req) doc = r.read(); print(doc.decode('utf-8'))