>[danger]每次訪問接口時，都必須攜帶5個公共參數，如果需要用戶信息的接口，還需要攜帶cowcms_userid參數（建議每個連接都攜帶該參數） | 參數名稱 | 參數描述 | | --- | --- | | appid | 接口網站分配個請求網站的appid | | interval | timestamp參數有效時時長 默認7200，單位為秒 | | timestamp | 請求時間戳，該值和當前時間差不能大于 interval 值（默認7200秒，時間在后臺可設置） | | nonceStr | 隨機字符串 | | signature | 請求簽名 | | cowcms_userid | 登錄用戶id 32位字符串，該參數在用戶登錄時，返回給前端的用戶登錄憑證,前端需要保存該憑證，在調用強制用戶登錄的接口時必傳該參數 | >[danger]調用API接口流程 1.獲取訪問API接口的必須參數。 2.將獲取的參數緩存到前端。 3.訪問接口時判定必須參數是否在有效時間內 4.如果參數有效直接訪問，如果參數無效，重新獲取然參數后，執行第二步 >站內調用接口獲取訪問API接口的必須參數 ``` namespace app\user\controller; use user\Member; class Sign extends Member { function getCowcmsUserid() { //$id API站點id，如果是本站默認id為1，開發者可根據自己需求填寫 $param = exeFun('getApiParam',[$id=1],'api'); dump($param) ; } } $param打印出來的參數為 array(5) { ["appid"] => string(40) "50fb0e2cde242fb428e5d35c719e82f3bfca8dcf" ["timestamp"] => int(1584416641) ["nonceStr"] => string(6) "gtug8k" ["signature"] => string(40) "fcee23aa9c3f9055d8d63e4cba51d71a630a03a3" ["interval"] => int(7200) } ``` >其它網站訪問接口獲取必須參數 ``` namespace app\user\controller; use user\Member; class Sign extends Member { function getCowcmsUserid() { $url = "http://xxxx.com/public/index.php/api/Apiget/get_param/appid/XXX/appsecret/XXXX/token/xxx" $param = http_curl($url); dump($param); } } $param打印出來的參數為 array(5) { ["appid"] => string(40) "50fb0e2cde242fb428e5d35c719e82f3bfca8dcf" ["timestamp"] => int(1584416641) ["nonceStr"] => string(6) "gtug8k" ["signature"] => string(40) "fcee23aa9c3f9055d8d63e4cba51d71a630a03a3" ["interval"] => int(7200) } ``` >[danger]自行生成訪問接口獲取必須參數，將 appid，appsecret，timestamp，nonceStr參數按照字典排序用&連接，進行（sha1或者md5，此處主要看后臺設置加密類型）加密生成signature簽名，如： signature =sha1（appid=6a9f5b5a0cd0594731113041f989e2a3a27afbcb&appsecret=aa0d037bfd95978e154aecb75739295681060346&nonceStr=8UsD7F&timestamp=1586238156） 2.將獲取的參數緩存到前端 ``` localStorage.setItem("appid","...."); localStorage.setItem("timestamp","...."); localStorage.setItem("nonceStr","...."); localStorage.setItem("signature","...."); localStorage.setItem("interval","...."); ``` 3.js每次訪問接口時,檢測timestamp是否失效，如果失效重新獲取參數，并緩存數據，否則訪問接口 ``` appid = localStorage.getItem("appid"); timestamp = localStorage.getItem("timestamp"); nonceStr = localStorage.getItem("nonceStr"); signature = localStorage.getItem("signature"); interval = localStorage.getItem("interval"); timestamp = (new Date()).getTime();; //當前時間戳 //提前10秒兌換新的參數 if(time - timestamp - interval > 10) { //參數失效，并重新獲取 url = "http://xxxx.com/public/index.php/api/Apiget/get_param_change"; param= {appid:'50fb0e2cde242fb428e5d35c719e82f3bfca8dcf',timestamp:1584418592,nonceStr:'IYI0wK',signature:'d3c512eef5bc25d09b767e75b8f5eff3bd91bec8'}; $.getJSON(url,param, function(json){ localStorage.setItem("appid","...."); localStorage.setItem("timestamp","...."); localStorage.setItem("nonceStr","...."); localStorage.setItem("signature","...."); localStorage.setItem("interval","...."); }); } ``` >cowcms_userid值的獲取 方式 當用戶登錄后由后端返回