loops-api

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Loops API and SDK Skill

Loops API 和 SDK Skill

This skill helps with Loops implementation workflows from application code. Use it for backend integrations, exact request guidance, and SDK or HTTP decisions.

此skill可帮助从应用代码中完成Loops实施工作流。适用于后端集成、精准请求指导以及SDK或HTTP方案选择。

When To Use

使用场景

Use this skill when the user needs to:

integrate Loops into an app, backend, webhook, or automation
decide between official SDKs and raw HTTP
manage contacts, contact properties, mailing lists, events, or transactional email
validate credentials or troubleshoot Loops request behavior from code

This skill is for implementation and operational usage, not broad email strategy or deliverability review.

当用户需要以下操作时使用此skill：

将Loops集成到应用、后端、webhook或自动化中
在官方SDK与原生HTTP请求之间做选择
管理联系人、联系人属性、邮件列表、事件或事务性电子邮件
验证凭证或排查代码中Loops请求的行为问题

此skill适用于实施和操作场景，不涉及宽泛的电子邮件策略或送达率审查。

Working Style

工作方式

When this skill is active:

Choose the right interface first: SDK or raw HTTP.
Prefer official SDKs for application code when the language has one.
Prefer raw HTTP only when no SDK is available or the user needs exact payload control.
Keep Loops requests server-side.
Verify exact behavior against the official docs or OpenAPI spec when details matter.
If the task is primarily about Loops CLI install, auth, shell usage, or command help, use the separate
```
loops-cli
```
skill.

Official references:

Docs:
```
https://loops.so/docs
```

API reference:

https://loops.so/docs/api-reference/intro

JavaScript SDK:
```
https://loops.so/docs/sdks/javascript
```
OpenAPI spec:
```
https://app.loops.so/openapi.json
```

当此skill激活时：

首先选择合适的接口：SDK或原生HTTP请求。
如果开发语言有官方SDK，在应用代码中优先使用官方SDK。
仅当没有可用SDK或用户需要精准控制负载时，才优先使用原生HTTP请求。
保持Loops请求在服务器端执行。
当涉及细节时，对照官方文档或OpenAPI规范验证具体行为。
如果任务主要涉及Loops CLI安装、认证、shell使用或命令帮助，请使用独立的
```
loops-cli
```
skill。

官方参考资料：

文档：
```
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
```

Choose The Interface

选择接口

SDK or HTTP API:
- application code
- backend services
- webhook handlers
- repeatable integrations Read
```
references/http-api.md
```

If the user is working from the terminal instead of writing application code, use the

loops-cli

skill.

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

如果用户是在终端操作而非编写应用代码，请使用

loops-cli

skill。

Category Routing

分类路由

Auth, base URL, rate limits, contacts, properties, lists, events, transactional payloads, SDK examples, and HTTP errors: Read
```
references/http-api.md
```

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

Output Checklist

输出检查清单

Aim to leave the user with:

the right API interface choice for the task
exact payload shapes or SDK usage
any Loops-specific caveats that affect behavior
the next validation step, such as a small test request or API-key check

目标为用户提供：

适合任务的正确API接口选择
精准的负载格式或SDK用法
任何影响行为的Loops特定注意事项
下一步验证步骤，例如小型测试请求或API密钥检查