API

REST API参考文档。包含147个服务的认证信息、端点以及注意事项。

设置

首次使用时，请阅读setup.md以获取使用指南。

使用时机

当用户询问关于集成第三方API时。此技能提供：

• 认证文档
• 包含curl示例的端点参考
• 速率限制与分页模式
• 需避免的常见错误

架构

apis/                    # API reference files by category
  ├── ai-ml.md           # OpenAI, Anthropic, Cohere, etc.
  ├── payments.md        # Stripe, PayPal, Square, etc.
  ├── communication.md   # Twilio, SendGrid, Slack, etc.
  └── ...

~/api/                   # User preferences (optional)
  └── preferences.md     # Preferred language for examples

快速参考

API 类别

如何浏览 API 文件

每个分类文件包含多个 API。使用每个文件顶部的索引：

1. 首先阅读索引— 每个文件开头都有一个索引表，显示API名称和行号
2. 跳转到特定API— 使用行号仅读取该部分（每部分50-100行）
3. 示例：

   # Read index
   head -20 apis/ai-ml.md
   # Read specific API section
   sed -n '119,230p' apis/ai-ml.md
   

核心规则

1. 首先找到正确的文件— 使用API分类表来定位服务。

2. 阅读索引，然后跳转— 每个文件都有一个索引。仅阅读你需要的部分。

3. 包含Content-Type— POST/PUT/PATCH请求需要Content-Type: application/json。

4. 处理速率限制— 检查X-RateLimit-Remaining头部。在收到429状态码时实施退避策略。

5. 验证响应— 某些API会返回200状态码，但错误信息在响应体中。请检查响应结构。

6. 使用幂等性密钥— 适用于支付和关键操作。

常见错误

• 缺失内容类型：application/json在 POST 请求中
• 在 URL 查询参数中放置 API 密钥（应改用请求头）
• 忽略分页（大多数 API 默认返回 10-25 条项目）
• 对 429/5xx 错误未设置重试逻辑
• 假设 HTTP 200 状态码即表示成功

范围

此技能是仅供文档查阅。它提供：

• API 端点参考
• 认证模式
• 供参考的代码示例

用户需自行管理其 API 密钥并自行运行命令。

外部端点

此技能文档化的是外部 API。所展示的示例端点分别对应相应的服务提供商（Stripe、OpenAI 等）。

相关技能

使用以下命令安装clawhub install <slug>如果用户确认：

• http— HTTP请求模式
• webhook— Webhook处理
• json— JSON处理

反馈

• 如果有用：clawhub star api
• 保持更新：clawhub sync