Publish Api

核心用法

API技能提供147+主流REST API的标准化集成方案，覆盖AI/ML、支付、通信、CRM、开发者工具等10大领域。核心工作流程：

1. 首次配置 - 阅读setup.md建立多账户凭据体系，采用{SERVICE}_{ACCOUNT}_{TYPE}命名规范（如STRIPE_PROD_API_KEY）
2. 查阅文档 - 每个API配备专属apis/{service}.md文件，包含认证方式、端点详情、速率限制与已知陷阱
3. 安全调用 - 通过环境变量注入凭据，配合curl示例直接发起请求，全程本地执行无代理

显著优点

• 覆盖面极广：147个API预置文档，从OpenAI、Stripe到Shopify、Notion一站式解决
• 多账户原生支持：生产/测试/客户项目环境隔离，变量命名规范避免冲突
• 陷阱预警机制：文档标注Common Traps（如415错误、分页遗漏、幂等键缺失）
• 零数据外泄：所有请求从用户机器直发API厂商，工具方不代理、不存储

潜在局限

• 需手动管理凭据：无内置密钥加密存储，依赖用户自行配置环境变量或密钥管理器
• curl为主：高级SDK特性（如Stripe的自动重试）需自行实现
• 文档更新延迟：新兴API版本变更可能滞后于官方文档

适合人群

• 全栈开发者快速对接第三方服务
• DevOps工程师配置多环境CI/CD凭据
• 独立开发者管理多客户项目API密钥

常规风险

• 凭据泄露：环境变量误提交至代码仓库（需配合.gitignore与pre-commit钩子）
• 速率限制触发：未监控X-RateLimit-Remaining导致服务中断
• 幂等性事故：支付类操作缺少idempotency key造成重复扣款

技术架构

apis/           # 147个API参考文档
~/api/          # 用户偏好与账户注册表（本地生成）

依赖curl与jq，支持Linux/macOS/Windows三平台。

核心功能与价值

API Skill 是一个纯文档型的第三方 API 集成参考库，涵盖 147+ 个主流服务（Stripe、OpenAI、Notion、GitHub、Twilio 等），按 AI/ML、支付、通信、CRM、开发者工具等 10+ 类别组织。每个 API 文档包含认证方式、端点说明、速率限制、分页模式及常见陷阱，提供可直接使用的 curl 示例。

核心用法：

• 快速查阅：通过 apis/{service}.md 获取特定 API 的完整文档
• 多账户管理：采用 {SERVICE}_{ACCOUNT}_{TYPE} 命名规范（如 STRIPE_PROD_API_KEY），支持生产/测试/多客户环境隔离
• 安全调用：强制使用 Header 传参、Content-Type 声明、幂等键（idempotency key）等最佳实践

显著优点

1. 零代码风险：100% Markdown 文档，无可执行代码，无动态加载，安全认证 S+ 级
2. 覆盖全面：从 AI 大模型到支付网关，从基础设施到生产力工具，一站式覆盖
3. 实战导向：每个 API 包含「gotchas」陷阱说明，如 Stripe 的 415 错误、GitHub 的 pagination .cursor 模式
4. 凭证安全：明确禁止硬编码，强制环境变量管理，配套 credentials.md 详细指南

局限与注意事项

1. T3 来源：个人开发者维护（ivangdavila），非企业级背书，生产环境需自行审计
2. 文档时效性：第三方 API 变更频繁，部分端点或认证方式可能滞后
3. 无自动化：仅提供参考文档，不生成代码、不验证请求、不处理响应
4. 网络直连：所有 API 调用由用户本地直接发起，需自行处理代理、防火墙等网络配置

适合人群

• 后端开发者：快速集成新服务，避免重复踩坑
• DevOps/SRE：管理多环境、多账户的 API 凭证体系
• 技术负责人：评估第三方服务技术方案，制定团队集成规范
• 全栈工程师：前后端联调时查阅认证与错误处理细节

常规风险与应对

| 风险场景 | 说明 | 缓解措施 |

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

| 凭证泄露 | 误将密钥提交至代码仓库 | 严格遵循环境变量规范，启用 git-secrets 等钩子 |

| 速率限制触发 | 未处理 429 响应导致服务中断 | 按文档实现指数退避 + jitter |

| 重复操作 | 网络超时重试导致重复扣款/创建 | 对关键操作强制使用幂等键 |

| 文档过时 | API 版本升级导致端点失效 | 集成前交叉验证官方最新文档 |

该 Skill 是开发者工具箱中安全、轻量的 API 知识库，适合作为集成工作的第一站参考。