使用说明

引用与署名

不管是在图表下方标一行，还是在段落末尾收一句，「熊猫赛场」四个字都要写全，别缩写、也别换成你习惯的叫法。读者顺着这一行找过来，才能看到和你手里一样的数字。

建议直接套用下面这个格式，四行信息按顺序写，不用额外加形容词：

数据来源：熊猫赛场
引用模块：外援名额归属
统计区间：近五个赛季
发布状态：已完成校验
原文路径：panda-sports-xiongmao.com.cn/product/

链接指向你实际取用的那个栏目。赛程节点、外援名额与号码归属来自 标注系统；按轮次更新的轮换记录与租借名单来自 动态与专题。同一段文字里引了多个模块，就分别列出来，不要合并成一句「数据来源：熊猫赛场」。

区间与来源标注

一条结论单独拿出来看，往往说明不了什么。读者真正要确认的是：这个数是从哪段比赛、哪份名单里算出来的。所以引用的时候，下面四项请一并保留。

节点类型

赛程节点、转会跟进、外援名额归属或球衣号码归属，写清是哪一类。

统计区间

近五个赛季、近三个赛季或单赛季，按你实际取用的那一档写。

数据来源

具体栏目路径精确到模块，不要只写站名。

发布状态

这条是已经完成校验，还是随窗口推进仍在调整。

客场胜率默认按近五个赛季统计。如果你换成近三个赛季或单赛季再引用，区间这一行必须跟着改，否则读者拿到的数字和你的结论对不上。

为什么换了区间，结论可能换方向

同一支球队，五年拉宽来看和只看最近一年，主客场表现常常不在同一条线上。阵容更替、主客场排布、赛程密度都会落进区间里。你写「客场偏弱」之前，先确认自己取的是哪一段；用的是近三个赛季，就在图注里写明「近三个赛季」，不要沿用页面默认的那一档。

转载与二次发布

下面几种用法，标好来源就可以直接用：把单条结论写进你的稿件、把整理好的表格放进社区帖子、照着我们的图示另做一版自己的配图。数值和区间照原样写，改配色、改排版都没问题。

另外几种情况需要先打声招呼，走 联络与核验 就行：整批导出后对外发布、把模块数据放进付费才能查看的内容、把查询能力接进你自己的产品对外提供。写清用途、覆盖范围和预计上线时间，我们按常规节奏回复。

• 不要改动结论里的数值，哪怕只是四舍五入。
• 不要删掉发布状态那一行，读者需要知道这条有没有变过。
• 不要把外援名额的两层视图合成一条来写。
• 不要把号码归属库里某个窗口的版本说成贯穿整个赛季的结果。

账号与访问规范

目前有 380 家媒体与内容团队通过接口取用标注结果，年调用量约 2400 万次。一个账号对应一个使用主体，编辑部内部多人共用可以，转给外部合作方就不行。

日常使用请按约定频率请求。结论本身有固定节奏：比赛日终场后 15 分钟内更新首发与轮换，转会窗口期每日 10:00 与 20:00 各核验一次。跟着这个节奏拉取，不用高频轮询也能拿到最新结果。

遇到下面几种情况，我们会先联系账号联系人：请求量明显超出约定、批量抓取全量记录、同一凭证在多个主体之间流转。确认属实后按提醒、限流、暂停的顺序处理，恢复正常使用后原账号继续有效。

接入过程中涉及的账号信息与访问记录，处理方式写在 隐私政策 里。

站点可用性与变更

维护窗口都安排在比赛日之外；碰到连续赛程，会顺延到最近的一段空档。维护开始和结束都会在 动态与专题 挂出提示，方便你安排稿件排期。

版本节奏是每赛季一个大版本、赛季中期两次小版本，目前运行到 v3.4。字段调整、模块拆分这类变动，会提前公告，写清涉及的模块、字段名和切换的版本号，你把变更说明按版本号顺序读一遍就能对上。

如果你在公告前就发现字段对不上，先把页面路径和条目编号记下来，按下一条联系我们。

发现对不上，怎么反馈

把页面路径、条目编号、你看到的数值和你认为正确的数值一起写清楚，有截图更好。这四样齐了，我们当天就能定位到具体条目，不必再来回问一轮。

反馈走 联络与核验，也可以直接发邮件到下面这个地址。工作日 9:00 至 18:00 都有人收，平均首次响应在 2 小时以内。

如果是接口侧的报错，把请求时间、接口名和返回状态码一并附上，比截一张图更省事。