api

Loops API 和 SDK 技能

此技能可帮助你在应用代码中实现 Loops 工作流，适用于后端集成、精确的请求指导，以及 SDK 或 HTTP 的选择。

何时使用

在用户需要以下操作时使用此技能：

• 将 Loops 集成到应用、后端、Webhook 或自动化流程中
• 在官方 SDK 和原始 HTTP 之间做出选择
• 管理联系人、联系人属性、邮件列表、事件或事务性邮件
• 验证凭据，或排查代码中的 Loops 请求行为

此技能用于实现和运维，不适用于广泛的邮件策略或送达率审查。

工作方式

启用此技能时：

1. 首先选择合适的接口：SDK 或原始 HTTP。
2. 如果该语言有官方 SDK，应用代码应优先使用官方 SDK。
3. 仅在没有可用 SDK 或用户需要精确控制载荷时，才优先选择原始 HTTP。
4. 将 Loops 请求保留在服务端。
5. 细节很重要时，请对照官方文档或 OpenAPI 规范核实具体行为。
6. 如果任务主要涉及 Loops CLI 的安装、身份验证、Shell 用法或命令帮助，请使用单独的 cli 技能。

官方参考资料：

• 文档：https://loops.so/docs
• API 参考：https://loops.so/docs/api-reference/intro
• JavaScript SDK：https://loops.so/docs/sdks/javascript
• OpenAPI 规范：https://app.loops.so/openapi.json

选择接口

• SDK 或 HTTP API：
  • 应用代码
  • 后端服务
  • Webhook 处理程序
  • 可重复使用的集成 阅读 references/http-api.md

如果用户在终端中操作，而不是编写应用代码，请使用 cli 技能。

分类路由

• 身份验证、基础 URL、速率限制、联系人、属性、列表、事件、事务性载荷、SDK 示例和 HTTP 错误： 阅读 references/http-api.md

输出检查清单

尽量为用户提供：

• 适合该任务的 API 接口选择
• 精确的载荷格式或 SDK 用法
• 影响行为的 Loops 特定注意事项
• 后续验证步骤，例如发送一个小型测试请求或检查 API 密钥