php对接飞书机器人

爬山虎还上班

已于 2023-10-20 10:12:21 修改

阅读量1.7k

点赞数 5

分类专栏： php 文章标签： php 飞书

于 2023-10-20 10:06:25 首次发布

本文链接：https://blog.csdn.net/jinborui2/article/details/133940051

版权

php 专栏收录该内容

21 篇文章

订阅专栏

本文讲述了开发者在与飞书机器人对接时遇到的响应错误，主要问题是签名验证失败。通过排查发现，问题出在对hash_hmac函数参数的理解上，正确使用方法是将空字符串作为第二个参数而非第三个。作者提供了一个PHP示例代码以供参考。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

有同事接到对接飞书机器人任务，开发中遇到响应错误：

{
        "code": 19021,
        "msg": "sign match fail or timestamp is not within one hour from current time"
}

意思应该就是签名错误或者时间戳不在有效范围内等，官方文档解释：

时间戳是取的实时的，也确认过了没问题，那基本确认就是签名错误了。

按照文档尝试调试了一下还是一样的结果，如果把后台安全设置那个签名去掉的话（即不用验签）使用curl请求立马就收到消息了：

curl -X POST -H "Content-Type: application/json" \
    -d '{"msg_type":"text","content":{"text":"request example"}}' \
    https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxx

问题还是签名上，文档书写如下：

示例代码缺少了php的，文档很简单就三步，拼接和base64肯定没问题，主要问题肯定就是加密算法那里了，尝试了hash('sha256',$sign),hash_hmac('sha256', $sign, true, true),hash_hmac('sha256', $sign, '**')，hash_hmac('sha256', $sign, '**',true);等等，结果最后同事咨询了技术支持居然是hash_hmac('sha256', '', $sign, true);

文档中说吧拼接字符串当做签名字符串，我想当然的以为要带入的参数是hash_hmac第二参数，结果没想到是第三个，也是自己对hash_hmac这个函数的认知比较低的缘故吧。只能说又涨知识了。不知道这是不是坑，希望对后面对接的人有帮助，写的小demo：

$url = 'https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxx';
$timestamp = time();
$secret = "abcdxxxxxx";//秘钥
$sign = $timestamp . "\n" . $secret;
$sign = base64_encode(hash_hmac('sha256', '', $sign, true));
$body = array(
    "timestamp" => $timestamp,
    "sign" => $sign,
    'msg_type' => 'text',
    'content' => ['text' => '这是一条测试数据']
);
$postData = json_encode($body);
$options = array(
    'http' => array(
        'method' => 'POST', 
        'header' => 'Content-type:application/json;charset=UTF-8', 
        'content' => $postData, 
        'timeout' => 60
    )
);
$context = stream_context_create($options);
$result = file_get_contents($url, false, $context);
var_dump($result);