帮我吧文档:数据接口:工单:签名认证

帮我吧查看历史工单免登录动态签名规则说明

注: 此规则仅当后台在工单模板开启链接保护签名项才生效。

1. URL必传参数:

  • signature 签名token
  • timestamp 13位时间戳
  • nonce 随机数
  • mobile 联系人手机号码(要对应帮我吧联系人手机号码)

2. 签名规则说明: - 对除signature外的全部参数签名,先字典升序后hash :

sha1(private_key,timestamp,nonce,param1...)
  • private_key: 私钥(在后台设置中生成和重置)
  • timestamp 时间戳1小时内有效
  • 其余参数根据实际需要传递
  • 中文参数UTF-8编码,必须urlencode

3. 签名代码示例(PHP版)

<?php
 
/**
 * 签名类
 * Class Signature
 */
 
class Signature{
    private $nonce;
    private $timestamp;
    private $private_key = 'aef2l3gze982ew';
 
    public function __construct()
    {
        $this->nonce = time();
        $this->timestamp = $this->getUnixMicroTime();
    }
 
    //获取13位时间戳
    protected function getUnixMicroTime() {
        $time = microtime(1);
        return floor($time * 1000);
    }
 
    //生成签名
    public function makeSignature(array $params){
        $params['private_key'] = $this->private_key;
        $params['timestamp'] = $this->timestamp;
        $params['nonce'] = $this->nonce;
        $tmpArr = array_values($params);
        sort($tmpArr, SORT_STRING);
        return $tmpStr = sha1(implode($tmpArr));
    }
}
 
//参数需要根据实际情况传递 
$params = [
    'mobile'=>'15564532345'
 
$signObj = new Signature();
$signature =  $signObj->makeSignature($params);

4. 最终生成的带签名的url链接示例:

注: 此链接打开后一小时后失效。

http://www.bangwo8.com/historyTicketList.php?aId=200637&ticketTemplateId=3&checkTicketStatus=1&timestamp=1569220445&mobile=17133958825&nonce=123456&signature=848137a37ce82d128b58bb3ca4ff804629f1832f


页面工具