使用指南
常见问题
关于日历、接口与账户,你可能想了解这些。
01使用与数据
本月和次月如何查看?
本月全部公开事件免费浏览。次月订阅即将开放,当前暂不能购买,也不能查看具体内容。
历史纪念是今年举办的活动吗?
不是。标题中的“历史纪念”表示过去发生的事件,仅用于内容回顾;它不代表今年的举办、上映或发布安排。
为什么有些日期只显示几条事件?
事件较多的日期默认显示前三条,点击“展开”可查看当天剩余事件,也可以再次收起。关键词搜索和分类筛选会检查本月全部事件。
02账户与密钥
如何领取 API Key?
先在个人中心注册或登录,完成图形验证码,再领取专属 API Key。完整密钥仅在领取或重置时显示,请及时保存。
所有接口都需要 API Key 吗?
所有日历业务接口都需要在 X-API-Key 请求头中提供密钥。网站本月日历可直接浏览,无需登录。请勿把密钥放进网址或公开网页代码。
重置 Key 后,原来的 Key 还能使用吗?
旧 Key 会立即失效,请在使用接口的应用中替换为新 Key。重置会保留今日用量与累计调用次数。
忘记登录密码怎么办?
当前暂不支持密码找回,请妥善保存用户名和密码。登录后可在个人中心的“账户安全”中修改密码。
03额度与订阅
免费接口有多少调用额度?
免费账户每天 100 次、每分钟 10 次成功事件查询。日额度在北京时间零点重置,不累计到下一天。
哪些请求会消耗额度?
事件列表、事件详情和本月日历共用额度;每次成功查询消耗一次,成功的空查询也计次。获取分类、日历配置和查看用量不扣额度,失败请求不扣查询额度。
现在可以购买订阅吗?
订阅正在准备中,暂未开放购买。你可以先免费浏览本月日历,或注册领取 API Key。
请求出错或额度用完时如何处理?
请先检查 Key 和查询日期是否有效。日期仅限北京时间本月;超限时按 Retry-After 响应头提示等待后重试。接口文档列出了各状态码和具体处理建议。
开始使用历见数据前往个人中心