使用指南

常见问题

关于日历、接口与账户,你可能想了解这些。

01使用与数据

本月和次月如何查看?

本月全部公开事件免费浏览。次月订阅即将开放,当前暂不能购买,也不能查看具体内容。

历史纪念是今年举办的活动吗?

不是。标题中的“历史纪念”表示过去发生的事件,仅用于内容回顾;它不代表今年的举办、上映或发布安排。

为什么有些日期只显示几条事件?

事件较多的日期默认显示前三条,点击“展开”可查看当天剩余事件,也可以再次收起。关键词搜索和分类筛选会检查本月全部事件。

02账户与密钥

如何领取 API Key?

先在个人中心注册或登录,完成图形验证码,再领取专属 API Key。完整密钥仅在领取或重置时显示,请及时保存。

所有接口都需要 API Key 吗?

所有日历业务接口都需要在 X-API-Key 请求头中提供密钥。网站本月日历可直接浏览,无需登录。请勿把密钥放进网址或公开网页代码。

重置 Key 后,原来的 Key 还能使用吗?

旧 Key 会立即失效,请在使用接口的应用中替换为新 Key。重置会保留今日用量与累计调用次数。

忘记登录密码怎么办?

当前暂不支持密码找回,请妥善保存用户名和密码。登录后可在个人中心的“账户安全”中修改密码。

03额度与订阅

免费接口有多少调用额度?

免费账户每天 100 次、每分钟 10 次成功事件查询。日额度在北京时间零点重置,不累计到下一天。

哪些请求会消耗额度?

事件列表、事件详情和本月日历共用额度;每次成功查询消耗一次,成功的空查询也计次。获取分类、日历配置和查看用量不扣额度,失败请求不扣查询额度。

现在可以购买订阅吗?

订阅正在准备中,暂未开放购买。你可以先免费浏览本月日历,或注册领取 API Key。

请求出错或额度用完时如何处理?

请先检查 Key 和查询日期是否有效。日期仅限北京时间本月;超限时按 Retry-After 响应头提示等待后重试。接口文档列出了各状态码和具体处理建议。

开始使用历见数据前往个人中心