错误说明

REST 错误响应遵循 RFC 9457，媒体类型为 application/problem+json。其中 type 是可解引用的主语义标识，code 是便于程序分支的稳定短码；调用方应优先按 type 理解错误，并可按 code 做本地映射。

{
  "type": "https://docs.zkogow.top/problems/invalid-date-format",
  "title": "日期格式无效",
  "status": 400,
  "detail": "日期必须使用 ISO 8601 yyyy-MM-dd 格式",
  "instance": "/v1/china-calendar/dates/2026-10-0",
  "code": "INVALID_DATE_FORMAT",
  "requestId": "f4935479-81fe-406f-b9d8-a4b67d6d6399"
}

requestId 用于向万端 API 支持渠道提供一次请求的定位信息；instance 是触发问题的请求路径。问题页只说明公开修复方式，不披露服务内部实现。

问题类型	code	推荐 HTTP 状态
日期格式无效	INVALID_DATE_FORMAT	400
缺少必填参数	MISSING_PARAMETER	400
日期区间无效	INVALID_DATE_RANGE	400
日期区间跨度过大	DATE_RANGE_TOO_LARGE	400
日期超出支持范围	DATE_OUT_OF_SUPPORTED_RANGE	400
日历数据暂时不可用	CALENDAR_DATA_UNAVAILABLE	503
资源不存在	RESOURCE_NOT_FOUND	404
方法不允许	METHOD_NOT_ALLOWED	405
服务内部错误	INTERNAL_ERROR	500

如果生产环境迁移域名，历史 type URI 仍会持续可访问；不要把 URI 字符串改写成新的域名。