Publish Api

核心用法

API skill 是一份面向开发者的离线API参考文档库，覆盖147个第三方服务的REST API集成信息。用户询问API集成时，skill 会按以下流程响应：

1. 定位服务：通过分类表（AI/ML、支付、通信、数据库等17个类别）找到目标API所属文件
2. 索引导航：先读取文件顶部的索引表，再跳转到具体API章节（每节50-100行）
3. 输出参考：提供认证方式、curl示例端点、速率限制、分页模式及常见陷阱

关键文件包括 setup.md（使用指南）、auth.md（认证模式）、pagination.md（分页模式）、resilience.md（错误处理）、webhooks.md（Webhook模式）。

显著优点

• 覆盖面极广：147个服务横跨AI、支付、通信、CRM、营销、DevOps、数据库、媒体等全场景
• 结构化查询：分类索引+行号跳转设计，避免全文扫描，响应高效
• 实战导向：不仅罗列端点，更强调Content-Type头、幂等键、429退避等工程细节
• 零配置即用：纯文档型skill，无需API密钥即可查询参考信息

潜在缺点与局限

• 文档静态性：API版本迭代快，文档可能存在滞后风险（需clawhub sync更新）
• 无执行能力：仅提供参考示例，用户需自行管理密钥、构造请求、处理响应
• 深度有限：每个API压缩在百行内，复杂场景（如OAuth2全流程、Webhook验证）需配合官方文档
• 语言偏好：示例以curl为主，用户需在~/api/preferences.md配置偏好的编程语言

适合人群

• 快速验证某API是否支持特定功能（"Stripe是否支持退款查询？"）
• 需要对比同类服务接口差异（对比SendGrid vs Resend的认证头）
• 排查集成中的常见错误（429处理、分页参数缺失）
• 新成员上手技术栈时了解API生态全景

常规风险

• 密钥泄露风险：文档示例含占位符密钥，用户复制粘贴时可能误用真实密钥到不安全位置
• 端点变更：外部服务API版本升级可能导致示例失效，生产环境需以官方文档为准
• 速率限制误判：文档中的rate limit值可能过期，实际以响应头X-RateLimit-Remaining为准
• 合规盲区：支付、医疗等敏感领域API需额外合规审查，本skill不覆盖合规建议

核心功能

该Skill是一份纯文档型的REST API参考手册，涵盖147个主流SaaS服务的API文档，按17个领域分类整理（AI/ML、支付、通信、CRM、开发者工具、数据库等）。用户可快速查询任意服务的认证方式、端点结构、cURL示例、速率限制及常见陷阱。

显著优点

1. 覆盖全面：从OpenAI、Stripe到Notion、Twilio，几乎涵盖现代开发常用的一切第三方服务
2. 结构化查阅：每个分类文件顶部设有索引表，标注各API所在行号，支持精准跳读
3. 实战导向：提供认证模式对比、分页策略、错误处理、Webhook处理等通用最佳实践
4. 零依赖零执行：纯Markdown文档，无可执行代码，无第三方依赖，安全风险极低

潜在局限

• 文档滞后性：第三方API更新频繁，文档可能与实际接口存在版本差异
• 需自行执行：仅提供参考，所有API调用需用户自行在终端或代码中实现
• 无交互调试：不提供沙箱环境或自动请求构造功能

适合人群

• 需要快速集成新API的后端/全栈开发者
• 评审第三方服务技术方案的架构师
• 查阅认证模式与错误处理规范的技术写作者

常规风险

该Skill本身无安全风险，但用户自行执行API调用时需注意：保护API Key（避免硬编码）、遵守速率限制、验证响应结构（部分API返回200但正文含错误）。建议通过环境变量管理凭证，并对生产流量实施重试与熔断机制。