NSFW Jokes API

An API delivering a curated, community-sourced collection of **NSFW jokes**. Whether you're building an adult humor app, spicing up a chatbot, or just need a laugh that doesn't hold back — this API has you covered with a growing library of jokes that aren't afraid to push the line, each one reviewed by a moderator before going live.

原始信息汇总

数据集概述：NSFW Jokes API

简介

NSFW Jokes API 是一个面向开发者的、由社区贡献并经人工审核的成人幽默笑话 API。数据库中的每条笑话在上线前都经过版主审核，确保内容质量。随着社区提交的审核通过，笑话库持续增长。

API 基本信息

• 类别： 娱乐 (Entertainment)
• 创建者： JohnMikko27
• 订阅者数： 2

核心功能与端点

1. GET /api/v1/jokes — 获取笑话

• 功能描述： 返回已审核笑话的分页列表，按 ID 升序排列。
• 查询参数：

  参数	类型	是否必填	默认值
  cursor	整数	否	1
  limit	整数	否	10

• 分页机制： 采用基于游标的分页。首次请求不带 cursor 参数。每次响应中的 meta.next_cursor 字段提供了下一页的起始 ID，将其作为 cursor 参数即可获取下一页。当 meta.next_cursor 为空字符串时，表示已到达最后一页。响应中还包含一个预构建的 meta.next URL，可直接用于跳转。

2. POST /api/v1/jokes — 提交笑话

• 功能描述： 向社区数据库提交一个新的笑话。提交的笑话会进入审核队列，审核通过后上线。重复的玩笑（setup + punchline 相同）会被自动拒绝。
• 请求体 (application/json)：

  字段	类型	是否必填	描述
  setup	字符串	是	笑话的铺垫或问题部分
  punchline	字符串	是	笑话的笑点或答案部分

数据模式 (Schemas)

Joke Object (笑话对象)

字段	类型	描述
id	字符串	唯一的笑话标识符
text	字符串	完整的笑话字符串（setup + punchline 组合）
setup	字符串	笑话的铺垫或问题部分
punchline	字符串	笑话的笑点或答案部分
is_approved	布尔值	对于 GET /jokes 返回的笑话，始终为 true
created_at	字符串	笑话提交时的 ISO 8601 时间戳

Response Envelope (成功响应)

• 所有成功响应均包含 success（布尔值，始终为 true）、data（笑话对象数组）、meta（分页信息对象，包含 next_cursor、next、message 字段）。

Meta Object (元数据对象)

字段	类型	描述
next_cursor	字符串	下一页的游标 ID，最后一页时为空字符串
next	字符串	下一页的预构建 URL，最后一页时为空字符串
message	字符串	状态消息，当列表为空或已遍历完时出现

错误处理

错误响应遵循一致的格式：{ "success": false, "error": { "code": "...", "message": "..." } }

状态码	描述
400	错误请求 —— 请求体中缺少 setup 或 punchline
401	未授权 —— 缺少或无效的 API 密钥
409	冲突 —— 具有相同 setup 和 punchline 的笑话已存在
500	服务器内部错误