调用中科闻歌API前须确认三件事：一、已获取有效app_id、app_secret及接口地址；二、提交文本≤5000字、UTF-8编码，批量请求需JSON数组格式；三、签名算法为HMAC-SHA256，原文格式为method=POST&path=…×tamp=…&nonce=…&body={…}，严格注意大小写、顺序与编码。
中科闻歌 API 接口调用前必须确认的三件事
中科闻歌的舆情分析服务（如趋势识别、情感判定、事件聚类）不提供公开 PHP SDK，所有调用都基于其 RESTful HTTP 接口。你不能直接 require 'zhongke_ai.php' 或 composer install 某个包——得自己拼请求、签名校验、处理响应。
- 确认你已从中科闻歌后台获取了有效的
app_id、app_secret和接口地址（通常是类似https://api.wenge.ai/v1/analysis/trend的 URL） - 确认你要提交的文本符合要求：单次请求通常限制在 5000 字以内，且需 UTF-8 编码；多文本批量分析需封装为 JSON 数组，不是换行分隔
- 确认签名算法是 HMAC-SHA256（他们文档明确写死），不是 MD5 或 RSA；签名原文格式为
method=POST&path=/v1/analysis/trend×tamp=1717023456&nonce=abc123&body={"text":"..."}，注意空格、顺序、URL 编码规则
PHP 中构造带签名的 POST 请求（cURL 版）
用 curl_init() 发起请求时，最容易出错的是时间戳（timestamp）和随机串（nonce）没同步生成、body 字符串参与签名前未做 json_encode($data, JSON_UNESCAPED_UNICODE)、签名后没放进 Authorization 请求头。
function callZhongKeTrend($text, $app_id, $app_secret, $api_url) {
$timestamp = time();
$nonce = substr(md5(uniqid()), 0, 8);
$body = ['text' => trim($text)];
$body_str = json_encode($body, JSON_UNESCAPED_UNICODE);
// 签名原文：注意 method 全大写、path 是 URI 路径部分（不含域名）、body 是原始 JSON 字符串（非 urlencode）
$sign_string = "method=POST&path=/v1/analysis/trend×tamp={$timestamp}&nonce={$nonce}&body={$body_str}";
$signature = hash_hmac('sha256', $sign_string, $app_secret);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body_str);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json; charset=utf-8',
"Authorization: {$app_id} {$timestamp} {$nonce} {$signature}"
]);
$response = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($http_code !== 200) {
throw new Exception("API error: {$http_code}, response: {$response}");
}
return json_decode($response, true);
}
// 使用示例
try {
$result = callZhongKeTrend(
"北京今天空气质量很差，PM2.5爆表，市民戴口罩出行",
'your_app_id_here',
'your_app_secret_here',
'https://api.wenge.ai/v1/analysis/trend'
);
var_dump($result['trend_label'], $result['confidence']);
} catch (Exception $e) {
echo $e->getMessage();
}
返回结果里「趋势」字段的实际结构与解析要点
别被“趋势”二字误导——中科闻歌这个接口返回的不是时间序列图，而是一个分类标签（如 "突发"、"升温"、"平稳"、"衰退"）加置信度。它不返回历史数据点，也不返回预测值，只是对当前文本所反映的舆情动态阶段做单点判断。
-
$result['trend_label']是字符串，可能为"升温"，但文档未保证枚举值完全固定，建议用in_array($label, ['突发','升温','平稳','衰退'])做安全判断 -
$result['confidence']是 float 类型，范围 0–1，低于 0.65 建议视为低置信，不要直接入库或触发告警 - 若返回
"error_code": 4001，大概率是app_secret错了或签名原文里body多了空格、少了引号；返回401则是app_id无效或过期
生产环境必须加的防护和兜底逻辑
直接裸跑上面那段代码上线会出问题：没有重试、没限流、没日志、没熔断。中科闻歌接口有调用频控（比如 10 QPS），PHP-FPM 子进程并发高时容易触发限流返回 429。
立即学习“PHP免费学习笔记（深入）”；
- 用
sleep(0.1)或 Redis 分布式锁控制单机每秒请求数，别依赖 nginx upstream 限流——他们鉴权在业务层 - 把
curl_exec()包进 try-catch，并对CURLE_COULDNT_CONNECT、CURLE_OPERATION_TIMEOUTED单独计数，连续 3 次失败就暂停该 worker 30 秒 - 记录每次请求的
timestamp、nonce、signature（脱敏后）、http_code到日志，排查签名失败时能快速比对原文
签名逻辑看着简单，但 timestamp 和 body 字符串的编码细节一旦错一位，服务器就返回 401 且不告诉你哪错了——建议先用 Python 写个最小验证脚本跑通再迁移到 PHP。
