首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >历史上的今天免费API接口教程

历史上的今天免费API接口教程

原创
作者头像
用户9840656
发布2025-07-11 11:11:02
发布2025-07-11 11:11:02
2190
举报
接口简介

历史上的今天​ 是一个免费API接口,可随机获取或按日期检索历史上的今天发生的重要事件。数据同步于百度百科,覆盖全面、权威可靠。支持返回事件标题、日期、关键词及百科链接,适合历史类应用、教育工具或内容聚合平台集成。


接口基础信息
  • 请求地址​:https://cn.apihz.cn/api/zici/today.php
  • 请求方式​:GETPOST
  • 请求参数​: 参数名必填说明id是用户中心的数字ID(需注册获取)key是用户中心通讯秘钥m否月份(1-12),需与d同时使用d否日期(1-31),需与m同时使用 📌 注意:
    1. 若不传 md,默认返回当日随机历史事件​(无结果则随机返回其他日期)。
    2. 公共测试ID(id=88888888key=88888888)有频次限制,​务必注册独享ID​(免费)。
  • 返回参数​: json复制{ "code": 200, // 状态码(200成功;400错误) "msg": "", // 错误提示(code=400时返回) "title": "事件标题", "y": "年份", // 如"1935" "m": "月份", // 如"07" "d": "日", // 如"06" "words": "关键词", "url": "百度百科链接" }

调用示例
1. PHP 示例(GET请求)
代码语言:javascript
复制
php复制<?php
$id = "10000000";   // 替换为你的ID
$key = "15he5h15ty854j5sr152hs2"; // 替换为你的KEY
$apiUrl = "https://cn.apihz.cn/api/zici/today.php";

// 可选:指定日期(如7月6日)
// $params = "id=$id&key=$key&m=07&d=06";
$params = "id=$id&key=$key"; // 默认今日随机事件

$response = file_get_contents("$apiUrl?$params");
$data = json_decode($response, true);

if ($data['code'] == 200) {
    echo "事件: " . $data['title'] . "\n";
    echo "日期: {$data['y']}年{$data['m']}月{$data['d']}日\n";
    echo "关键词: " . $data['words'] . "\n";
    echo "百科链接: " . $data['url'];
} else {
    echo "错误: " . $data['msg'];
}
?>
2. Python 示例(GET请求)
代码语言:javascript
复制
python运行复制import requests

id = "10000000"      # 替换为你的ID
key = "15he5h15ty854j5sr152hs2"  # 替换为你的KEY
params = {
    "id": id,
    "key": key,
    # "m": "07",    # 可选:指定月份
    # "d": "06"     # 可选:指定日期
}

url = "https://cn.apihz.cn/api/zici/today.php"
response = requests.get(url, params=params)
data = response.json()

if data["code"] == 200:
    print(f"事件: {data['title']}")
    print(f"日期: {data['y']}年{data['m']}月{data['d']}日")
    print(f"关键词: {data['words']}")
    print(f"百科链接: {data['url']}")
else:
    print(f"错误: {data['msg']}")

注意事项
  1. 免费但需注册​: 访问 接口盒子官网 注册获取独享 idkey,避免公共ID的频次限制。
  2. 错误处理​:
    • code=400 时检查 msg(常见错误:秘钥无效、参数缺失)。
  3. 数据逻辑​:
    • 指定日期无事件时,随机返回其他日期事件。
    • 关键词(words)可直接联动百度百科API扩展详情。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 接口简介
  • 接口基础信息
  • 调用示例
    • 1. PHP 示例(GET请求)
    • 2. Python 示例(GET请求)
  • 注意事项
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档