| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| h | datetime | 否 | 需要返回的时间,24小时制,默认为当前时间整点时间。 | 18 |
[
{
"name": "h",
"type": "datetime",
"required": false,
"description": "需要返回的时间,24小时制,默认为当前时间整点时间。",
"example": "18"
}
]
{"openapi":"3.1.1","info":{"title":"整点报时","description":"指定时间返回一句问候、语音,默认为当前整点时间。","version":"1.0.0"},"paths":{"/v1/zs_zdbs.php":{"get":{"summary":"整点报时","description":"指定时间返回一句问候、语音,默认为当前整点时间。","parameters":[{"name":"h","in":"query","required":false,"schema":{"type":"string","example":"18"},"description":"需要返回的时间,24小时制,默认为当前时间整点时间。"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"summary":"整点报时","description":"指定时间返回一句问候、语音,默认为当前整点时间。","parameters":[{"name":"h","in":"query","required":false,"schema":{"type":"string","example":"18"},"description":"需要返回的时间,24小时制,默认为当前时间整点时间。"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"servers":[{"url":"http://xiaoapi.cn","description":"当前访问入口(http)"}]}
{
"code": 200,
"msg": "下午六点了,美味的晚餐正等着你哦!",
"time": "2025-06-30 18:00",
"mp3": "https://xiaoapi.cn/v1/data/baoshi/18.mp3",
"tips": "慕名API:http://xiaoapi.cn"
}
提供整点报时服务,可指定 24 小时制时间获取对应整点的问候语和语音播报资源,默认返回当前时刻的整点报时内容。适用于需要定时提醒或整点播报场景的开发者集成使用。
https://xiaoapi.cn/v1/zs_zdbs.php
GET、POST
无需密钥。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| h | datetime | 否 | 需要返回的时间,24小时制,默认为当前时间整点时间。 |
h:传入 0~23 的整数值,代表 24 小时制的小时数,如 18 表示下午六点。不传该参数时自动获取当前整点时间。{
"code": 200,
"msg": "下午六点了,美味的晚餐正等着你哦!",
"time": "2025-06-30 18:00",
"mp3": "https://xiaoapi.cn/v1/data/baoshi/18.mp3",
"tips": "慕名API:http://xiaoapi.cn"
}
| 字段 | 类型 | 描述 |
|---|---|---|
| code | int | 状态码,200 表示成功 |
| msg | string | 整点报时的问候语内容 |
| time | string | 报时时间,格式为 YYYY-MM-DD HH:00 |
| mp3 | string | 对应整点时刻的语音文件 URL |
| tips | string | 提示信息内容 |
{
"code": 0,
"msg": "服务暂不可用",
"errcode": 11017
}
| 错误码 | 说明 |
|---|---|
| 11001 | 未提供调用密钥 |
| 11002 | 密钥错误 |
| 11003 | 密钥已禁用 |
| 11004 | 积分余额不足 |
| 11005 | 请求过于频繁(QPM 限制) |
| 11006 | 接口维护中 |
| 11007 | 接口已禁用 |
| 11008 | 接口不可用 |
| 11009 | 密钥校验暂不可用 |
| 11010 | 积分系统暂不可用 |
| 11011 | 收费接口须提供有效密钥 |
| 11012 | 鉴权方式错误 |
| 11013 | 接口不存在 |
| 11014 | ***地址无效 |
| 11015 | ***地址不允许 |
| 11016 | ***请求失败 |
| 11017 | 服务暂不可用 |
| 11018 | 请求方式不允许 |
| 11019 | 当前IP不在白名单内 |
| 11020 | 启用出口代理须提供有效密钥 |
| 11021 | 未配置可用出口代理 |
| 11022 | 出口代理不可用 |
| 11023 | 密钥已过期 |
| 11024 | 令牌分配积分不足 |
# 获取当前整点报时
curl "https://xiaoapi.cn/v1/zs_zdbs.php"
# 获取指定时间(18点)的报时
curl "https://xiaoapi.cn/v1/zs_zdbs.php?h=18"
// 获取当前整点报时
$response = file_get_contents("https://xiaoapi.cn/v1/zs_zdbs.php");
// 获取指定时间(18点)的报时
$url = "https://xiaoapi.cn/v1/zs_zdbs.php?h=18";
$response = file_get_contents($url);
// 解析返回的 JSON 数据
$data = json_decode($response, true);
echo $data["msg"];
h 参数为 24 小时制小时值,取值范围为 0 至 23,传入值需在合法范围内。mp3 字段为语音文件链接,指向第三方资源,建议使用时做好可用性校验。暂无代码示例。管理员可在后台用 AI 生成或手动编写。
// 结果将在此处显示