全新肯定语 API

从无尽的循环到即时的身心疗愈：肯定语 API 已完成全面重构，以零摩擦的方式呈现个性化、每日传递的正能量。如今每条肯定语都附带稳定的 ID、干净整洁的数据和丰富的 schema——同时还提供搜索、分页、批量与每日端点、完整的健康工具包，以及适用于短信和语音助手的纯文本响应。

🚀 全新亮点

稳定的 ID – 每条肯定语都带有一致的基于哈希生成的 id，让小组件、通知和缓存始终保持同步。
数据自动净化 – 文本和分类字段在到达你的应用之前，多余的空白字符都会被清除。
智能分类 – 19 个分类直接源自数据集并经过排序，不会出现硬编码带来的偏差。
友好的错误提示 – 遇到未知分类会返回清晰的 404，而不会挂起或陷入循环。
更丰富的 schema – 每条肯定语都会返回 id、text、category、mood、lang 和 length。
精准找到所需内容 – 列表端点支持搜索和分页，另有一个可配置的批量端点。
确定性的每日精选 – /today 为每位用户返回相同的当日肯定语。
健康工具包 – 按名字进行个性化定制、重构消极思维，并将肯定语与呼吸练习搭配使用。

🛠 API 端点

1. 列出肯定语

GET /v1/affirmations

参数：

category（可选）：按分类筛选列表，例如 confidence 或 self-love。
search（可选）：对肯定语文本进行全文搜索。
page（默认值：1）：用于分页的页码。
limit（默认值：10）：每页返回的结果数量，最多 50 条。
lang（默认值：en）：语言代码。本版本返回英文内容。

2. 随机肯定语

GET /v1/affirmations/random

参数：

category（可选）：从指定分类中返回一条随机肯定语。
lang（默认值：en）：语言代码。本版本返回英文内容。
format（默认值：json）：使用 json 返回完整对象，或使用 text 返回纯文本响应。

3. 按分类获取随机肯定语

GET /v1/affirmations/categories/{category}/random

参数：

category（必填）：要从中挑选的分类，例如 sleep。未知分类会返回清晰的 404。

4. 列出分类

GET /v1/affirmations/categories

返回完整且经过排序的分类列表——从 anxiety-relief、calm 到 confidence、focus、gratitude、parenting、resilience、self-love、sleep、success 等等。

5. 批量肯定语

GET /v1/affirmations/batch

参数：

category（可选）：按分类筛选批量结果。
limit（默认值：10）：要返回的肯定语数量，最多 50 条。
lang（默认值：en）：语言代码。本版本返回英文内容。

6. 今日肯定语

GET /v1/affirmations/today

参数：

category（可选）：在某个分类中返回确定性的每日精选。
lang（默认值：en）：语言代码。本版本返回英文内容。

/daily 别名会返回相同的当日肯定语。

7. 个性化定制

POST /v1/affirmations/personalize

请求体：

mood（可选）：要从中选取的心情或分类，例如 confidence。默认为 happiness。
goal（可选）：肯定语背后的意图。
name（可选）：要融入肯定语中的名字，例如 “I am confident, Ava.”

8. 重构消极思维

POST /v1/affirmations/reframe

请求体：

negativeThought（必填）：要重构的想法，例如 “I always fail”。

返回一段重构后的表述，并搭配一条契合的 resilience 肯定语。

9. 肯定语 + 呼吸练习组合

GET /v1/affirmations/bundle

参数：

category（可选）：要从中选取的分类。sleep 分类会返回 4-7-8 呼吸练习；其他所有分类则返回 box 呼吸练习。

10. 建议时间表

GET /v1/affirmations/schedule

参数：

timezone（可选）：建议时段所用的时区标签，例如 Europe/Berlin。默认为 UTC。

📦 响应示例

随机肯定语：

{
  "id": 1874329517,
  "text": "I am confident, capable, and ready for today.",
  "category": "confidence",
  "mood": "confidence",
  "lang": "en",
  "length": 42
}

个性化肯定语：

{
  "id": 55123874,
  "text": "I am confident, Ava.",
  "category": "confidence",
  "mood": "confidence",
  "lang": "en",
  "length": 20
}

重构后的想法：

{
  "reframe": "Even though \"I always fail\", I choose to believe: I am learning and growing every day.",
  "affirmation": {
    "id": 912345678,
    "text": "I am learning and growing every day.",
    "category": "resilience",
    "mood": "resilience",
    "lang": "en",
    "length": 36
  }
}

健康组合：

{
  "affirmation": {
    "id": 44556677,
    "text": "I release the day and welcome rest.",
    "category": "sleep",
    "mood": "sleep",
    "lang": "en",
    "length": 36
  },
  "breathing": {
    "name": "4-7-8",
    "steps": ["Inhale 4s", "Hold 7s", "Exhale 8s"]
  }
}

建议时间表：

{
  "morning": "08:00 Europe/Berlin",
  "evening": "21:00 Europe/Berlin",
  "timezone": "Europe/Berlin"
}

✨ 多格式响应

随机端点同时支持 JSON 和纯文本。在 Web 和移动应用中使用 ?format=json（默认值）获取完整的结构化对象，或在短信流程、语音助手和小组件中使用 ?format=text 获取可直接发送的字符串。

🎯 适用人群

开发者：正在构建健康类应用、聊天机器人和激励功能，希望获得稳定且文档完善的 API。
产品经理：希望通过每日通知、连续打卡和确定性的每日内容来提升用户参与度。
健康应用创作者：需要可大规模获取、分类清晰的可靠肯定语内容。
企业团队：期待可扩展、SDK 风格的端点，以及可直接上手的 Postman 引导。

🌟 为什么选择肯定语 API？

天生可靠：稳定的 ID、净化后的数据以及清晰的 404 提示，意味着生产环境中更少意外。
按需提供深度：19 个分类，涵盖从缓解焦虑到自我关爱的方方面面。
不止一次调用：在同一个 API 中实现个性化定制、思维重构、呼吸练习组合与时间安排。
对开发者友好：搜索、分页、批处理、多格式响应，以及开箱即用的代码片段。
为健康而生：99.99% 的正常运行时间，低延迟响应，陪伴每一天的正能量时刻。

🚀 快速上手

Postman 集合：导入 docs/affirmations-postman.json，一键探索每一个端点。
代码片段：从 docs/affirmations-snippets.md 复制可直接运行的 cURL、JavaScript 和 Python 示例。
适配 LLM：docs/llms.txt 为 AI 智能体提供该 API 的结构化摘要。

从今天开始构建正能量时刻——调用 today 端点获取确定性的每日肯定语，然后加入个性化定制和呼吸练习组合，打造完整的健康体验。