开发者

三套接口:AI 大模型版本查询免密钥直接 GET;时间日历 API MCP 需要密钥、按调用扣积分。左侧选一节,右侧每个接口都能填密钥直接试。

GET /api/v1/calendar

一个入口,用 op 选能力。权限 calendar:read

填入后,下面每个接口都可以直接发送。密钥只存在这个标签页里,关掉即清。在 API 令牌 创建。每次成功鉴权的调用扣 1 积分,参数写错也会扣。

curl -H "Authorization: Bearer ha_pat_xxx" \
  "https://handapp.com/api/v1/calendar?op=day&date=2026-02-17"

每个响应都带两个头:x-credits-charged(这次扣了多少)与 x-credits-balance(还剩多少)。不用另外查余额。

day

date=YYYY-MM-DD

某天的农历、干支、生肖、星座、节气、节日、法定节假日与黄历宜忌

GET /api/v1/calendar?op=day&date=2026-08-17

lunar2solar

year&month&day&isLeap

农历转公历

GET /api/v1/calendar?op=lunar2solar&year=2027&month=1&day=1&isLeap=false

solarTerms

year

某年的二十四节气及公历日期

GET /api/v1/calendar?op=solarTerms&year=2026

workdays

from&to

区间内的工作日数(扣周末与法定节假日、算回调休)

GET /api/v1/calendar?op=workdays&from=2026-08-17&to=2026-08-31

nthWorkday

from&n

从某天起第 N 个工作日,n 可为负

GET /api/v1/calendar?op=nthWorkday&from=2026-08-17&n=10