api

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Loops API and SDK Skill

Loops API与SDK技能

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

本技能可帮助你从应用代码中实现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.

当用户需要以下服务时，可使用本技能：

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

本技能适用于实现与运维场景，不涉及宽泛的邮件策略或送达率评估。

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
```
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
```

当本技能启用时：

首先选择合适的接口：SDK或原生HTTP请求。
若开发语言有官方SDK，在应用代码中优先使用官方SDK。
仅当没有对应SDK，或用户需要精准控制请求负载时，才选择原生HTTP请求。
确保Loops请求在服务器端执行。
当涉及细节时，对照官方文档或OpenAPI规范验证具体行为。
如果任务主要涉及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
```

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

cli

skill.

SDK或HTTP API适用场景：
- 应用代码
- 后端服务
- Webhook处理器
- 可重复的集成流程请参阅
```
references/http-api.md
```

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

cli

技能。

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密钥检查