OpenClaw / Agent API

本站提供 HTTP JSON 接口，便于在 OpenClaw 等环境中配置为工具：根据生辰与出生地计算禄命古法命局摘要，并在携带有效 API Key 时返回当日运势等完整字段。

端点

POST https://cdndns.org/api/agent/bazi

请将完整 URL 与部署环境中的 APP_URL 保持一致。

鉴权与配额

可选请求头：Authorization: Bearer <你的 API Key>
API Key 在登录后于「我的 API Key」页面创建，与老黄历 JSON 等接口共用同一套 Key 与计数。
每个 Key 自然日最多 20 次；同一账户下所有 Key 合计自然日最多 30 次（超限返回 429）。
未携带有效 Key 时：服务端仍可根据 IP 处理请求，但同一 IP 每自然日最多 10 次（超限 429）；且响应中 daily_fortune 为锁定态，详见下文。

请求体（JSON）

字段	必填	说明
birth_date	是	公历生辰，推荐 `YYYY-MM-DDTHH:MM` 或 `YYYY-MM-DD HH:MM:SS`
birth_place	否	出生地，默认「北京」；用于真太阳时等排盘
gender	否	「男」/「女」或 `1`/`0`、`male` 等

响应概要

natal_fortune：本命局相关分数与说明（匿名与授权均会返回主体结构）
daily_fortune：授权后为当日流日运势结构；未授权时为锁定态（如 status: LOCKED_REQUIRE_PREMIUM、teaser 等）
audit_status：数据完整性 / 风险级等元信息
logic_reference、SYSTEM_INSTRUCTION：面向 Agent 的逻辑与回复约定（集成时请一并尊重响应内说明）

调用示例

curl -X POST "https://cdndns.org/api/agent/bazi" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <你的API_KEY>" \
  -d '{"birth_date":"1990-05-15T10:30","birth_place":"北京","gender":"男"}'

机器可读契约

OpenAPI 3 描述：https://cdndns.org/static/openapi/agent-api.json
本站 llms.txt：https://cdndns.org/llms.txt