內(nèi)容設(shè)計(jì)
使用人人秀API服務(wù)，需要在人人秀平臺(tái)申請(qǐng)開通該服務(wù)，申請(qǐng)地址：
人人秀API接口必須含有下面3個(gè)參數(shù)
參數(shù)名 | 類型 | 說(shuō)明 |
app_key | string(32) | 人人秀平臺(tái)分配的AppKey |
time_stamp | string(14) | 1970-01-01開始的時(shí)間戳，精確到毫秒 |
sign | string(32) | 根據(jù)簽名算法計(jì)算所得 |
第1步，設(shè)所有發(fā)送或者接收到的數(shù)據(jù)為集合M，將集合M內(nèi)?空參數(shù)值的參數(shù)按照參數(shù)名ASCII碼 從小到大排序（字典序），使用URL鍵值對(duì)的格式（即key1=value1&key2=value2…）拼接成字符串stringA。
特別注意以下重要規(guī)則：
參數(shù)名ASCII碼從小到?排序（字典序）；
如果參數(shù)的值為空不參與簽名；
參數(shù)名區(qū)分小寫；
??秀平臺(tái)主動(dòng)發(fā)起的請(qǐng)求時(shí)，傳送的sign參數(shù)不參與簽名，將?成的簽名與該sign值作校驗(yàn)；
??秀平臺(tái)接?可能增加字段，簽名驗(yàn)證必須遍歷所有參數(shù) ；
第2步，在stringA最后拼接得到stringSignTemp字符串，并對(duì)stringSignTemp進(jìn)?MD5運(yùn) 算，再將得到的字符串所有字符轉(zhuǎn)換為?寫，得到sign值signValue。
eRdLi88c6I6L95PFSX1Nq69Y84xLcD3T
假設(shè)某接口需要傳送如下信息：
openid： ot1UbuBBzlE6IjEDWfyXQW3dy2S4
transaction_no： 69201704060281699381
time_stamp： 1543999047492
nonce_str： ibuaiVcKdpRxkhJA
order_no： 19201704060281699381
按照API接口規(guī)范，實(shí)際需要傳遞信息為：
app_key： 96c84928b1dce057d110ea3b3880fc83
time_stamp： 1543999047492
sign:
openid： ot1UbuBBzlE6IjEDWfyXQW3dy2S4
transaction_no： 69201704060281699381
nonce_str： ibuaiVcKdpRxkhJA
order_no： 19201704060281699381
按照簽名算法計(jì)算sign：
第1步：對(duì)參數(shù)按照key=value的格式，并按照參數(shù)名ASCII字典序排序如下：
stringA="app_key=96c84928b1dce057d110ea3b3880fc83&nonce_str= ibuaiVcKdpRxkhJA&openid=ot1UbuBBzlE6IjEDWfyXQW3dy2S4&order_no= 19201704060281699381&time_stamp=1543999047492&transaction_no=69201704060281699381";
第2步：拼接AppSecret： stringSignTemp=stringA+"&app_secret=eRdLi88c6I6L95PFSX1Nq69Y84xLcD3T"
sign=MD5(stringSignTemp).toUpperCase() //得到C17482AB45EA3C724CB648223ED8E2D2
最后得到最終發(fā)送的數(shù)據(jù)：
app_key： 96c84928b1dce057d110ea3b3880fc83
time_stamp： 1543999047492
sign:
openid： ot1UbuBBzlE6IjEDWfyXQW3dy2S4
transaction_no： 69201704060281699381
nonce_str： ibuaiVcKdpRxkhJA
order_no： 19201704060281699381
必須在服務(wù)器端計(jì)算簽名
客戶端?成簽名地址，可能會(huì)導(dǎo)致以下問(wèn)題：
客戶端易被破解，AppSecret有外泄的?險(xiǎn)，危害嚴(yán)重！
如果?戶的?機(jī)端時(shí)鐘不準(zhǔn)，或者不在北京時(shí)區(qū)，會(huì)導(dǎo)致時(shí)間驗(yàn)證過(guò)期，?法訪問(wèn)。 因此簽名地址務(wù)必在服務(wù)器端?成。
如不按要求，由此導(dǎo)致的損失，??秀概不負(fù)責(zé)!
簽名過(guò)期檢查
由??秀對(duì)商戶平臺(tái)發(fā)起的請(qǐng)求，請(qǐng)求參數(shù)?會(huì)有time_stamp(時(shí)間戳字段)，請(qǐng)商戶平臺(tái)務(wù)必根據(jù)此字段對(duì)請(qǐng)求的簽名做過(guò)期處理，??秀平臺(tái)建議過(guò)期時(shí)間為10分鐘。
簽名失敗的問(wèn)題排查
是否為編碼異常導(dǎo)致。??秀的請(qǐng)求部分參數(shù)會(huì)帶有中?字符，第三方開發(fā)者需要先對(duì)請(qǐng)求參數(shù)做URLDecode 解碼，可以在簽名時(shí)遍歷簽名參數(shù)排查是否有字符亂碼。
時(shí)間戳是否精確到毫秒，部分平臺(tái)代碼?成的時(shí)間戳是精確到秒的，需要轉(zhuǎn)換?下
示例代碼
// 計(jì)算簽名類
class RrxAPI
{
protected $values = array();
public function __construct($data=array())
{
foreach ($data as &$d){
// 參數(shù)解碼
$d = urldecode($d);
}
$this->values = $data;
}
/**
* 簽名生成算法
* @param string $secret API密鑰
* @return string 簽名
*/
public function makeSign($secret){
//簽名步驟一：按字典序排序參數(shù)
ksort($this->values);
$string = $this->ToUrlParams();
//簽名步驟二：在string后加入app_secret
$string = $string . "&app_secret=".$secret;
//簽名步驟三：MD5加密
$string = md5($string);
//簽名步驟四：所有字符轉(zhuǎn)為大寫
$result = strtoupper($string);
return $result;
}
/**
* 格式化參數(shù)格式化成url參數(shù)
*/
private function ToUrlParams()
{
$buff = "";
foreach ($this->values as $k => $v)
{
// 排除簽名參數(shù)sign 、空值 、 數(shù)組
if($k != "sign" && $v != "" && !is_array($v)){
$buff .= $k . "=" . $v . "&";
}
}
$buff = trim($buff, "&");
return $buff;
}
}
// 調(diào)用簽名方法，計(jì)算簽名
$query_data=[
'app_key'=>'test_app_key',
'openid'=>'test_openid',
'time_stamp'=>'1543999047492',
'name'=>'張飛'
];
$apiSdk = new RrxAPI($query_data);
$secret = 'test_secret';
$sign=$apiSdk->makeSign($secret);
得到簽名為 8F4CC38010A6F917E788ED99518BD589
