「内容审计」(content-audit)是数据鱼API平台提供的内容运营量化接口,Base 路径 /api/content-audit,共 3 个端点。它面向已发布内容的存量维护场景,提供两个独立的小型计算能力:一是内容衰退分析(decay),按内容距上次更新的天数与流量变化幅度计算衰退指数,并给出需要采取的动作建议与优先级;二是词汇独特性分析(uniqueness),对一段文本统计总词数、去重词数与词汇多样性比率,给出重复度提示。
衰退指数的口径:decay_index = (距上次更新天数 / 365) × (1 − 流量变化百分比 / 100),结果保留两位小数。流量增长会压低指数、流量下滑会放大指数;指数大于 0.8 建议立即更新(Refresh Immediately,优先级 1),大于 0.5 建议规划更新(Plan Update,优先级 2),否则视为健康(Healthy,优先级 3)。
独特性分析的口径:按空格分词统计英文词汇,比率低于 0.4 判定为重复内容(Repetitive content),否则提示多样性良好(Good diversity)。接口为纯本地计算,无数据库与外部上游依赖,与其他数据鱼API接口共用统一 JSON 响应信封,适合批量嵌入内容巡检脚本。
方法 | 路径 | 说明 | 鉴权 |
|---|---|---|---|
GET | /api/content-audit/ping | 健康检查,返回 status ok | 免鉴权 |
GET | /api/content-audit/decay | 内容衰退指数与更新建议 | 是 |
POST | /api/content-audit/uniqueness | 文本词汇独特性与多样性分析 | 是 |
X-API-Key 请求头或 ?api_key= 查询参数传递;缺失返回 4011,无效返回 4013。{"code": 0, "msg": "success", "data": {...}};参数可放 JSON body、表单或 query,参数名一致。返回 status ok,用于存活探测。
GET /api/content-audit/ping{"code": 0, "msg": "success", "data": {"status": "ok"}}按更新时间与流量变化计算衰退指数与处理优先级。
参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
days | int | 否 | 0 | 距上次更新的天数 |
traffic_change | number | 否 | 0 | 流量变化百分比,负数表示下滑,如 -10 |
返回字段:days_since_update(回显天数)、traffic_trend(格式化百分比字符串,如 -10%)、decay_index(衰退指数)、action_needed(Refresh Immediately / Plan Update / Healthy)、priority(1/2/3,数字越小越紧急)。实测 days=400、traffic_change=-10 时指数为 1.21,判定 Refresh Immediately、优先级 1。参数缺省时按 0 天、0% 流量变化计算,得指数 0、Healthy。
GET /api/content-audit/decay?days=400&traffic_change=-10对文本做分词统计与多样性比率计算。
参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
text | string | 否 | — | 待分析文本;为空或统计不到词汇时返回 4002 |
返回字段:total_words(总词数)、unique_words(去重词数)、lexical_diversity(多样性百分比字符串)、quality_hint(低于 0.4 为 Repetitive content,否则 Good diversity)。实测文本统计得 11 词、去重 8 词,多样性 72.73%:
POST /api/content-audit/uniqueness
Content-Type: application/json
{"text": "the quick brown fox jumps over the lazy dog the fox"}text 参数在参数表中标注为非必填,但缺省即空文本,同样触发 4002;实际上该端点必须传入有效英文文本才有意义。原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。