本文将介绍如何使用接口盒子提供的免费API接口获取当前北京时间，包含多种时间格式返回方式。该接口支持POST和GET请求，适合各类开发场景。
接口基本信息
- 接口名称：取当前北京时间
- 请求地址：
https://cn.apihz.cn/api/time/getapi.php - 请求方式：POST或GET
- 接口状态：免费（需注册获取个人ID和KEY）
- 频次限制：
- 公共ID/KEY：共享每分钟调用限制
- 个人ID/KEY：独享每分钟调用限制
- 每日调用无上限
请求参数说明
| 参数名称 | 必填 | 示例值 | 说明 |
| id | 是 | 10000000 |
用户中心的数字ID |
| key | 是 | 15he5h15... |
用户中心通讯秘钥 |
| type | 是 | 1（整数1-20） |
返回格式类型（详见下方示例） |
返回参数说明
- 状态码（code）：
200：请求成功400：请求失败（需重试）
- 消息内容（msg）：
- 成功时返回时间数据
- 失败时返回错误信息（如
{"code":400,"msg":"查询失败,请重试。"}）
返回格式示例（type参数）
| type值 | 返回格式示例 | 说明 |
| 1 | {"code":200,"msg":"1710925735"} |
时间戳（秒级） |
| 2 | {"code":200,"msg":"2024-11-12 13:14:15"} |
标准日期时间 |
| 3 | {"code":200,"msg":"2024年11月12日13时14分15秒"} |
中文格式时间 |
| 6 | {"code":200,"msg":"20241112131415"} |
年月日时分秒（紧凑格式） |
| 20 | {"code":200,"y":"2025","m":"02",...,"sjc":1739354641} |
结构化时间+时间戳 |
注：type支持1-20种格式，完整列表见官方文档。
调用示例（Python）
python
运行
复制
import requests # 替换成自己的ID和KEY（注册地址：https://www.apihz.cn/user/） params = { "id": "10000000", # 用户ID "key": "your_key_here",# 用户KEY "type": "2" # 返回标准时间格式 } # 发送GET请求 response = requests.get( url="https://cn.apihz.cn/api/time/getapi.php", params=params ) # 处理响应 if response.status_code == 200: data = response.json() if data["code"] == 200: print("当前北京时间:", data["msg"]) else: print("错误:", data["msg"]) else: print("请求失败，状态码:", response.status_code)
注意事项
- 注册账号：
必须注册接口盒子账号获取个人ID和KEY，避免使用公共ID（88888888）触发频次限制。 - 参数要求：
id和key需严格匹配用户中心信息type必须是1-20的整数
- 失败处理：
返回code=400时建议重试或检查参数。
应用场景
- 服务器时间同步
- 跨时区应用统一时间基准
- 日志记录时间戳生成
- 定时任务触发
