生成一次性授权码，提供给 Hermes、自定义脚本或其他支持 CalorieFlow Agent API 的工具。授权后它们只能在你的授权范围内访问饮食、体重、消耗等业务数据，不能修改密码、邮箱或后台设置。
授权码
5 分钟内有效，只显示一次。请只发给你信任的 AI 助手。
📖
开发者与 AI 助手集成指南
▼
你可以通过以下方式为你的 AI 助手（如 Hermes）或脚本配置接入能力：
🔑 配对码换取 Bearer Token 示例：
curl -X POST http://localhost:8000/api/auth/agents/exchange \
-H "Content-Type: application/json" \
-d '{
"code": "XXXX-XXXX-XXXX",
"client_name": "My AI Assistant",
"client_type": "hermes"
}'
📝 请求说明与幂等写入：
- 鉴权请求头格式：
Authorization: Bearer cfa_...
- 支持幂等写入：在
POST /api/intake 载荷中附带唯一的 external_id 字段，可避免由于网络重试导致的重复记录。
- 日期与时间格式：采用 ISO 8601 格式，日期
YYYY-MM-DD，时间 HH:MM。