php怎么调用字节跳动穿山甲_php如何接入广告SDK后端回调验证

浅晨吖_1425

浅晨吖_1425

2026-03-21

576人浏览

原创

穿山甲回调验签失败的根本原因是未按其隐式规则预处理参数:需ksort排序、保留空值、参数串+密钥(非HMAC)顺序MD5,且price为字符串分单位。

php怎么调用字节跳动穿山甲_php如何接入广告sdk后端回调验证

穿山甲回调验签失败:sign 校验总不通过

根本原因不是算法写错了,而是穿山甲文档里没明说的「参数预处理规则」被跳过了。他们要求对所有回调参数(包括 callback_id、ad_type、price 等)先按字段名 ASCII 升序排序,再拼成 key1=value1&key2=value2 形式,最后用 md5 + 密钥计算签名——但很多人直接用 $_POST 原始顺序拼串,或漏掉空值字段。

实操建议:

  • 必须用 ksort($_POST) 排序,不能依赖表单提交顺序
  • 空字符串字段(如 click_id 可能为空)也要参与拼接,值为 "",不能跳过
  • 密钥是穿山甲后台「应用管理 → 应用详情 → 服务端回调密钥」里配的那个,不是 AppKey 或 SecretKey
  • 拼接时字段名和等号间无空格,& 前后也无空格,例如:ad_type=reward&callback_id=xxx&price=0.12

PHP 验签代码里 md5() 和 hash_hmac() 该用哪个

穿山甲目前只支持 md5 签名方式(v2 版本回调),不是 HMAC。官方文档写的是「MD5(key+string)」,实际是 md5($string . $secret_key) —— 注意是「参数串在前、密钥在后」,不是反过来,也不是 hash_hmac('md5', $string, $secret_key)。

示例关键片段:

$params = $_POST;
unset($params['sign']); // 先剔除 sign 字段
ksort($params);
$string = http_build_query($params, '', '&', PHP_QUERY_RFC3986); // 保证编码一致
$expected_sign = md5($string . $secret_key); // 注意顺序!
if ($expected_sign !== $_POST['sign']) {
    http_response_code(400);
    exit('sign invalid');
}

回调接口被重复调用或收不到请求

穿山甲服务端回调有重试机制(失败时最多重试 3 次,间隔约 1s/3s/10s),且要求你的接口在 3 秒内返回 HTTP 200。超时、返回非 200、或响应体含非空内容(比如 echo 'ok')都会触发重试。

常见踩坑点:

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理:站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载
  • PHP 脚本开头有 echo、var_dump 或 BOM 头,导致响应体非空
  • 用了 sleep() 或数据库慢查询,响应时间超过 3 秒
  • Nginx 配置了 fastcgi_read_timeout 小于 3s
  • 没做幂等处理,同一 callback_id 多次入库,造成重复计费

建议:收到回调后立即记录原始 $_POST 到日志,再校验;校验通过后先查库确认 callback_id 是否已存在,存在则直接返回 200。

price 字段单位和精度问题

穿山甲回调里的 price 是字符串格式的「分」为单位的整数(例如展示一次广告收益 0.12 元,传的是 "12"),不是浮点数也不是元。很多开发者直接 (float)$_POST['price'] 当元来用,结果精度丢失或小数点错位。

正确做法:

  • 始终把 price 当字符串处理,用 intval() 转成整数分
  • 入库或结算时统一用「分」为单位存储,避免浮点运算
  • 注意穿山甲可能传 "0"(未出价)或 "123"(1.23 元),不会传 "1.23"

验签时也必须用原始字符串拼接,不能先转数字再拼——否则 "007" 会变成 "7",签名就崩了。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

php

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2763

5

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

6970

13

后端的主要工作内容介绍
后端的主要工作内容介绍

后端是应用程序的服务端部分,负责核心任务,如数据库交互、业务逻辑处理和响应客户端请求。想了解更多后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

6466

10

php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

11924

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

6841

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2195

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

4348

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

5054

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3991

9

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习