Publish Api

核心用法

API Skill 是一个纯文档型技能，为开发者提供 147 个第三方 REST API 的完整参考。内容按业务场景分类（AI/ML、支付、通信、CRM 等），每个 API 包含认证模式、curl 示例、速率限制说明和常见陷阱。用户首次使用时需阅读 setup.md 了解导航规则，后续通过文件索引快速定位所需 API 片段（通常 50-100 行），避免阅读冗长文档。

显著优点

• 覆盖全面：从 OpenAI、Stripe 到小众服务如 Attio、Cal.com，涵盖 17 个垂直领域
• 实战导向：提供 curl 命令、认证头示例、幂等键使用等可直接复用的代码片段
• 高效检索：采用「索引+跳转」架构，通过 head/sed 等命令快速定位，无需全文加载
• 持续维护：版本 1.3.4 表明活跃迭代，changelog 承诺文档同步更新
• 生态协同：与 http、webhook、json 等技能形成开发工具链

潜在局限

• 纯文档性质：不提供 API 调用执行能力，密钥管理和实际请求需用户自行处理
• 无交互调试：缺少请求构造器、响应格式化或错误诊断工具
• 更新延迟风险：第三方 API 变更可能滞后于官方文档
• 平台依赖：需配合 clawic 生态使用，独立价值有限

适合人群

• 需要快速查阅多平台 API 规范的后端/全栈开发者
• 构建集成层、自动化工作流或内部工具的平台工程师
• 评估第三方服务技术可行性的技术决策者
• 学习 REST API 设计模式的初级开发者

常规风险

• 密钥泄露风险：文档示例含占位符密钥，用户可能误复制真实凭证到不安全环境
• 速率限制误判：文档中的限流数值可能过时，生产环境需以实时响应头为准
• 端点漂移：部分服务（尤其 AI 领域）API 版本迭代快，需交叉验证官方文档
• 无沙箱提示：支付类 API 未明确区分测试/生产环境配置差异

核心用法

本skill是面向开发者的纯文档型API参考库，涵盖147个主流第三方服务的REST API认证模式、端点说明、速率限制及常见陷阱。用户通过自然语言查询特定API的集成方法时，系统会检索对应分类文档（如apis/ai-ml.md、apis/payments.md等），提供结构化的curl示例与最佳实践。

使用流程

1. 定位服务类别：通过17个预分类快速定位目标API（AI/ML、支付、通信、数据库等）
2. 索引跳转：每个分类文件顶部含索引表，支持按行号精准定位特定API章节
3. 查阅示例：获取认证头格式、请求体结构、分页模式、错误码处理等完整信息

显著优点

• 覆盖广度：集成Stripe、OpenAI、Notion等147个服务，横跨17个垂直领域，省去分散查阅官方文档的时间成本
• 结构化呈现：统一的文档模板（认证→端点→分页→错误处理），降低跨API学习成本
• 安全设计：纯Markdown文档，无可执行代码；凭证示例强制使用环境变量占位符（$SERVICE_API_KEY），从源头避免密钥泄露风险
• 工程化细节：内置速率限制处理、幂等性键使用、Webhook验证等生产级实践

潜在局限

• 静态文档滞后性：API版本迭代时文档可能未及时同步（安全报告建议建立定期更新机制）
• 无交互验证：需用户自行在测试环境验证curl示例，skill本身不提供沙箱或模拟响应
• 深度不足：单个API篇幅控制在50-100行，复杂场景（如Stripe Connect、OAuth2全流程）需跳转官方文档

适合人群

• 需要快速集成新API的全栈/后端工程师
• 维护多服务商集成的技术团队（统一查阅入口）
• 学习REST API设计模式的开发者

常规风险

| 风险点 | 说明 | 缓解措施 |

|--------|------|----------|

| 凭证误用 | 用户可能误将示例复制到生产代码 | 文档强制使用环境变量占位符，SKILL.md反复强调用户自行管理密钥 |

| 端点变更 | 第三方API版本更新导致文档过时 | 建议用户执行前核对服务商官方文档最新版本 |

| 速率限制触发 | 高频curl测试可能触发服务商限流 | 文档内置`X-RateLimit-Remaining`检查与退避逻辑说明 |