本文将介绍如何使用接口盒子(apihz.cn)提供的免费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
时建议重试或检查参数。
应用场景
- 服务器时间同步
- 跨时区应用统一时间基准
- 日志记录时间戳生成
- 定时任务触发