JokeAPI

简介

JokeAPI 提供六大类笑话——编程、综合、暗黑、双关、万圣节和圣诞——支持单句和“铺垫+包袱”两种形式。无需 API 密钥，支持 CORS，可按内容标记过滤（nsfw、宗教、政治、种族、性别歧视、露骨）。非常适合演示、聊天机器人和开发者工具。

快速开始

随机编程笑话：

curl "https://v2.jokeapi.dev/joke/Programming"

安全无害的单句笑话：

curl "https://v2.jokeapi.dev/joke/Programming?type=single&blacklistFlags=nsfw,religious,political,racist,sexist,explicit"

响应示例：

{
  "error": false,
  "category": "Programming",
  "type": "single",
  "joke": "Algorithm: A word used by programmers when they don't want to explain how their code works.",
  "flags": { "nsfw": false, "religious": false, "political": false, "racist": false, "sexist": false, "explicit": false },
  "safe": true
}

指定分类的双段笑话（铺垫 + 包袱）：

curl "https://v2.jokeapi.dev/joke/Any?type=twopart&amount=2"

参数

认证方式

无需认证——完全免密钥。

速率限制与注意事项

• 免费开放；没有明确的硬性限制，但请合理使用。
• 响应中 error: false 表示返回了笑话；error: true 表示没有匹配（例如 contains 过滤掉了所有结果）。
• safe 字段是现成的“合家欢”过滤标记，很方便。

常见问题

JokeAPI 免费吗？ 是的——免费、免密钥、支持 CORS。

如何获取“安全”的笑话？ 传 blacklistFlags=nsfw,religious,political,racist,sexist,explicit，或按响应的 safe 字段过滤。

可以在浏览器直接用吗？ 可以——已启用 CORS，前端 fetch 可直接调用。