疯狂星期四文案接口接入：action、category 与 count 参数用法

适用场景

运营活动、社群互动、内容社区的每日话题，常常需要一段现成的短文案。疯狂星期四文案接口随机返回一段 KFC「疯狂星期四」文学，内置 52 条精选文案，覆盖情感、搞笑、职场、文艺、学术、古风、悬疑、科幻、鸡汤、日常 10 个分类。它支持随机、批量、分类列表与疯四倒计时四种用法，适合做每日一更的栏目内容、社群定时推送的素材，或给文案编辑提供灵感起点。

需要提前说明：接口内置的是固定条目的文案集合，返回的是这些条目中的内容，不生成新文本。因此它适合做「随机取一条」这类需求，不适合要求每篇都全新的场景。

接口能力边界

action决定这次要做什么：取随机文案、按分类取、批量取、列分类，还是查倒计时。category用于指定分类。count用于批量场景指定数量。三者配合使用，具体取值与组合方式以文档为准。

准备事项与参数填写

第一次调用前需要确认三件事：

1. action的可用取值：它决定请求目的，文档中会列出随机、批量、分类列表、倒计时分别对应什么值；
2. 分类名称写法：category要填文档给出的分类名，中文名称的写法要一致，不要自行简写；
3. 鉴权字段：名称与放置位置以文档为准，本文用YOUR_API_KEY占位。

参数填写上有两个容易忽略的点。第一，count只在批量场景下有意义，随机取一条时不需要传，传了也可能被忽略。第二，category与action要搭配，如果action是列分类，category就不必填。把这两个关系搞清楚，可以少走很多弯路。

curl 接入示例

先看随机取一条的最小请求：

curl -X GET 'https://v1.apizero.cn/api/crazy-thursday' \ -H 'Authorization: Bearer YOUR_API_KEY'

如果要按分类取，把category加进查询串；要批量取，再补上count：

curl -X GET 'https://v1.apizero.cn/api/crazy-thursday?action=文档规定的取值&category=搞笑&count=5' \ -H 'Authorization: Bearer YOUR_API_KEY'

action与category的准确取值以文档为准，示例中的值仅用于说明参数位置。方法是 GET，参数放在 URL 查询串上，不需要请求体。

用代码接入

以 Python 的requests为例，把参数组织成字典，按需拼装：

import requests URL = "https://v1.apizero.cn/api/crazy-thursday" API_KEY = "YOUR_API_KEY" # 按文档要求替换 def crazy_thursday(action: str = "", category: str = "", count: int = 0) -> dict: params = {} if action: params["action"] = action if category: params["category"] = category if count: params["count"] = count headers = {"Authorization": f"Bearer {API_KEY}"} # 以文档为准 resp = requests.get(URL, params=params, headers=headers, timeout=10) resp.raise_for_status() return resp.json() if __name__ == "__main__": print(crazy_thursday(category="搞笑", count=3))

把参数放进params由 requests 自动编码，中文分类名不会因为手拼 URL 而出现乱码。

返回值解读

返回内容的核心是文案文本本身，按action的不同，返回形态会有区别。阅读时注意以下几点：

• 随机取一条时，重点看返回的文案内容与所属分类；
• 批量取时，确认返回条目数是否与count一致，不一致通常是count超出可用范围；
• 列分类时，返回的是分类清单，用于前端下拉框；
• 查倒计时时，返回的是距离下一次的时间信息，具体字段以文档为准。

如果返回里带有分类字段，建议记录下来，便于后续按分类做内容统计。文案作为展示内容，前端渲染时要做转义，避免其中包含的符号破坏页面结构。

常见错误

错误码的具体数值与含义以文档为准，不要凭经验推断。

工程化注意事项

1. 分类名统一来源：不要在代码里硬编码分类名，改为调用分类列表接口取值，避免文案侧调整后失配。
2. 重复控制：内置文案共 52 条，做每日推送时建议记录近期已用条目，避免短期内重复。
3. 内容转义：文案属于外部内容，渲染到页面或推送到社群前要做转义与长度截断。
4. 失败兜底：接口不可用时准备本地备用文案，不要因为一次请求失败导致栏目开天窗。
5. 缓存策略：批量取到的结果可以短期缓存，随机取一条则不建议缓存，否则会失去随机性。

参考文档

• 疯狂星期四文案文档