17370845950

调用中科闻歌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。

• 用 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。