如果你正在找一个「随叫随到、库存巨大、还不要钱」的笑话接口接口盒子的随机笑话API基本就是为你准备的。随机返回一条中文小笑话20 万库存请求方式宽松到 GET、POST 都行返回又是标准 JSON不管是塞进网站侧边栏、做聊天机器人彩蛋还是写个命令行摸鱼脚本都能直接上手。一、接口基本信息项目说明接口名称随机笑话[20万]请求地址https://cn.apihz.cn/api/zici/xiaohua.php请求方式GET 或 POST鉴权方式用户IDid 用户KEYkey返回格式JSON费用接口本身免费每日调用无上限频率限制公共ID/KEY共享分钟级限频私有ID/KEY独享二、请求参数两个参数都是必填缺一个都会直接 400。参数名含义示例id用户中心的数字ID10000000key用户中心通讯秘钥15he5h15ty854j5sr152hs2三、返回参数接口用code当业务状态码200成功、400出错这点一定要记住——笑话正文不在msg里而在content字段。参数名说明code200成功400错误msg信息提示成功时也可能带提示content笑话正文内容只有code200才有意义成功返回示例{ code: 200, content: 两只母鸡在聊天看到一只公鸡无精打彩的走来母鸡问「咋地了没精神」公鸡说「做点生意」母鸡问「做啥生意累这德性啊」公鸡不好意思的说「嗯卖点鸡精。」 }失败返回示例{ code: 400, msg: 通讯秘钥错误。 }四、GET 请求示例最简单的玩法浏览器地址栏直接敲https://接口盒子/api/zici/xiaohua.php?id88888888key88888888五、PHP 调用示例方式一GET 请求file_get_contents适合环境没开 cURL 的轻量场景几行代码搞定。?php $userId 你的ID; $apiKey 你的KEY; // 2. 拼接 GET URL $apiUrl https://接口盒子/api/zici/xiaohua.php?id{$userId}key{$apiKey}; // 3. 发送请求并解析 JSON $response file_get_contents($apiUrl); $data json_decode($response, true); // 4. 根据 code 判断结果 if ($data[code] 200) { echo 随机笑话 . $data[content]; } else { echo ❌ 请求失败 . $data[msg]; } ?方式二POST 请求cURL推荐生产环境更推荐 cURL能设超时、能抓错误稳得多。?php $apiUrl https://接口盒子/api/zici/xiaohua.php; $userId 你的ID; $apiKey 你的KEY; // 2. 初始化 cURL $ch curl_init(); curl_setopt($ch, CURLOPT_URL, $apiUrl); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_TIMEOUT, 10); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, [ id $userId, key $apiKey ]); // 3. 执行请求 $response curl_exec($ch); // 4. 错误处理 if ($response false) { echo 请求失败 . curl_error($ch); curl_close($ch); exit; } $httpCode curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); // 5. 解析并返回笑话 $data json_decode($response, true); if ($httpCode 200 $data[code] 200) { echo 随机笑话 . $data[content]; } else { echo ❌ 错误码 . $data[code] . 信息 . $data[msg]; } ?六、Python 调用示例方式一GET 请求先装依赖pip install requests。import requests # 1. 替换为自己的 ID 和 KEY user_id 你的ID api_key 你的KEY # 2. 发送 GET 请求 params { id: user_id, key: api_key } try: response requests.get( https://接口盒子/api/zici/xiaohua.php, paramsparams, timeout10 ) # 3. HTTP 层和业务层双层判断 if response.status_code 200: data response.json() if data[code] 200: print( 随机笑话 data[content]) else: print(❌ 业务错误 data[msg]) else: print(❌ HTTP错误码 str(response.status_code)) except requests.exceptions.RequestException as e: print(❌ 网络异常 str(e))方式二POST 请求推荐import requests from requests.exceptions import RequestException # 1. 配置凭证 api_url https://接口盒子/api/zici/xiaohua.php user_id 你的ID api_key 你的KEY # 2. 表单数据 data { id: user_id, key: api_key } try: # 3. 发送 POST 请求记得加 timeout response requests.post(api_url, datadata, timeout10) response.raise_for_status() # 非 2xx 直接抛异常 result response.json() if result[code] 200: print( 随机笑话) print(result[content]) else: print(❌ 接口返回错误 result[msg]) except RequestException as e: print(❌ 请求异常 str(e))七、常见错误排查现象原因解决办法code:400, msg:通讯秘钥错误ID 或 KEY 填错去用户中心核对公共KEY偶尔调不通分钟级限频被打满换自己的私有ID/KEY超时无响应网络或SSL问题加timeout检查服务器出站HTTPS拿到数据却没有笑话误读字段正文在content不在msg八、使用注意事项KEY 别硬编码在前端PHP/Python 服务端调用没问题但如果是网页 AJAX 直调KEY 会直接暴露建议走自己的后端中转。content 可能含换行前端渲染时记得把\n换成br不然排版会乱。九、能用在哪这个接口虽然简单但落地场景不少网站侧边栏/ footer 随机显示一句笑话缓解用户等待焦虑微信/QQ 机器人收到「讲笑话」指令时调用命令行工具joke命令上班摸鱼专用登录页、404 页、加载页的趣味文案每日推送脚本定时把笑话发到群里的「快乐担当」