Publish Api

核心用法

API Skill 是面向开发者的第三方服务集成工具，支持147个主流API的快速接入。核心工作流：读取 apis/{service}.md 获取认证方式与端点详情 → 按 {SERVICE}_{ACCOUNT}_{TYPE} 命名规范配置环境变量 → 使用curl示例发起请求。

关键能力包括：

• 多账户凭证系统：通过命名隔离区分生产/测试/客户环境（如 STRIPE_PROD_API_KEY vs STRIPE_TEST_API_KEY）
• 动态API发现：覆盖AI/ML（OpenAI、Anthropic）、支付（Stripe、PayPal）、通信（Twilio、Slack）、CRM（HubSpot、Salesforce）、云基础设施（Vercel、Cloudflare）等15大类别
• 模式化陷阱规避：内置 auth.md、pagination.md、resilience.md 等专项指南，预防认证失败、分页遗漏、速率限制触发

显著优点

1. 安全架构设计：强制环境变量存储，禁止硬编码；多账户命名规范从根本上避免凭证串用事故
2. 生产级细节：每个API文档标注速率限制头（X-RateLimit-Remaining）、幂等键使用场景、静默415错误成因
3. 零代理调用：请求直接从本地发往目标API，无中间服务器，数据不经过第三方
4. 广泛兼容性：依赖curl/jq，支持Linux/macOS/Windows三平台

潜在缺点与局限性

• 无自动重试机制：需手动实现指数退避，skill仅提供 resilience.md 参考模式
• 静态文档维护：API供应商接口变更可能存在滞后，需用户自行验证
• 命令行门槛高：纯curl示例，无SDK封装，非技术用户上手困难
• 无实时测试功能：不提供沙箱环境或请求调试工具，需借助 http skill 补充

适合人群

• 后端开发者：快速接入支付、通知、AI等基础设施
• DevOps/SRE：管理多环境、多客户的API凭证配置
• 技术型产品经理/增长工程师：需直接操作HubSpot、Segment等数据工具的轻量集成

常规风险

| 风险类型 | 说明 | 缓解措施 |

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

| 凭证泄露 | 误将`.env`提交至版本控制 | 遵循 `.gitignore` 最佳实践，使用 `credentials.md` 持久化方案 |

| 生产数据误操作 | 测试脚本误连生产环境 | 严格执行 `{ACCOUNT}` 命名段区分，代码中增加环境断言 |

| 速率限制触发 | 批量操作未节流导致服务封禁 | 前置检查 `X-RateLimit-Remaining`，实现客户端令牌桶 |

| 幂等性失效 | 网络超时重试造成重复扣款 | 关键操作强制注入 `Idempotency-Key` 头 |

核心用法

API Skill 是一个纯文档集合，提供 147+ 个主流 REST API 的集成参考。用户通过阅读 apis/{service}.md 获取特定服务的认证方式、端点文档、curl 示例、速率限制及常见陷阱。首次使用时阅读 setup.md 完成配置，通过环境变量按 {SERVICE}_{ACCOUNT}_{TYPE} 规范命名凭证，支持多账户隔离。

关键文档矩阵：

• setup.md — 首次配置指南
• credentials.md — 多账户凭证系统
• auth.md / pagination.md / resilience.md / webhooks.md — 安全与模式陷阱
• apis/ — 147 个 API 专属文档（Stripe、OpenAI、Notion、GitHub、Twilio 等）

显著优点

极致安全设计：纯 Markdown 文档，无可执行代码、脚本或二进制文件，静态分析满分。零依赖（仅需系统预装 curl/jq），不发起网络请求，不代理、不存储任何 API 调用。

专业凭证管理：强制环境变量存储，禁止硬编码；{SERVICE}_{ACCOUNT}_{TYPE} 命名规范实现生产/测试/客户项目多账户隔离，从源头避免环境混淆导致的泄露事故。

全面安全指导：内置 7 项核心规则（Content-Type 强制、速率限制主动追踪、响应体校验、幂等键使用等），配套常见陷阱清单（415 错误、URL 参数泄露、分页遗漏、200 假成功等）。

生态覆盖广泛：15 大类 147 个 API，涵盖 AI/ML、支付、通信、CRM、开发者工具、数据库/认证、媒体、社交、生产力等全场景。

潜在缺点与局限性

纯被动文档：不执行任何代码，无自动化集成、无 SDK 封装、无类型安全，用户需手动编写和调试 curl 命令。

维护依赖：API 提供商接口变更时，文档可能滞后；用户需自行验证端点有效性。

无高级功能：无请求编排、无缓存、无流式处理、无 GraphQL 支持，复杂场景需配合其他工具。

适合人群

• 安全敏感型团队：需要 API 集成参考但拒绝执行不可信代码的环境
• 多账户运维者：管理生产/测试/多客户 API 凭证的 DevOps/SRE
• API 调试人员：偏好直接 curl 调试、需要快速查阅 auth 模式和分页策略的开发者
• 合规严格要求场景：金融、医疗等需零第三方代码执行的数据安全环境

常规风险

用户操作风险（非技能本身）：环境变量误配置可能导致凭证泄露至 shell 历史；curl 命令复制时可能遗漏转义字符；幂等键未使用导致重复扣款等支付事故。建议配合 http、webhook、json 等关联技能强化工作流安全。

版本滞后风险：API 提供商弃用端点时文档未同步更新，可能引发调试时间损失。