> ## Documentation Index
> Fetch the complete documentation index at: https://developers.effilink.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 核心概念

在深入具体功能之前，先了解 EffiLink 平台背后的核心概念会很有帮助。本页介绍您在每次集成中都会遇到的基础构件。

## API 端点

所有 EffiLink API 请求都发送至您所调用的对应地理位置的API端点，例如中国大陆：

```text theme={null}
https://api.effilink.co
```

每个请求都必须使用 HTTPS，并包含 `Content-Type: application/json` 以及认证请求头。详见[认证](/zh/docs/authentication)。

## 已验证发件人

**已验证发件人** 是您在 EffiLink 上注册并证明所有权的邮件地址或域名。您无法通过未注册的地址发送邮件。验证过程包括在您的域名上设置 DNS 记录（SPF、DKIM、DMARC）。

发件人按照发送邮件的目的不同，对应以下3种邮件类型：

* **验证码（OTP）邮件**：例如找回密码、登录确认、注册激活等
* **触发类事务邮件**：例如系统通知、账单提醒等
* **营销邮件**：例如电子期刊、产品推广等

## 联系人与联系人列表

**联系人** 是通过邮件地址或手机号标识的单个收件人。联系人可以携带自定义属性（例如姓名、公司、生日）。

**联系组** 是一组具名的联系人集合。发送营销活动时，您可以指定一个或多个联系组作为目标。联系组还可用作排除组（Repel Group），以过滤不希望送达的收件人。

## 列表任务（发送任务）

**列表任务**（或称发送任务）是营销邮件或短信活动的工作单元。创建邮件列表任务时，需要指定：

* 发件人地址与名称
* 邮件主题与内容（或模板）
* 目标联系人/联系组
* 计划发送时间（或立即发送）

列表任务可被查询、取消和删除。

## 邮件模板

**邮件模板** 是保存在EffiLink 账户中的可复用 HTML 邮件设计。模板中可包含 `{{tagName}}` 格式的个性化标签，在发送时被替换为实际值。您可以通过 API 或 EffiLink 控制台管理模板。

## 个性化标签

个性化标签让您可以在邮件主题和正文中注入动态内容。在内容或模板中使用 `{{tagName}}` 格式，然后在 API 请求的 `params` 字段中提供对应的值。

```json theme={null}
{
  "content": "<p>你好，{{firstName}}！您的订单 {{orderId}} 已发货。</p>",
  "params": {
    "firstName": "小明",
    "orderId": "ORD-1234"
  }
}
```

## 沙箱模式

**沙箱模式** 让您可以在不发送真实邮件或短信、不消耗额度、不影响线上数据的前提下测试 API 调用。在请求体中传入 `"sandboxMode": true`，API 会校验请求并返回相同结构的响应，但实际不会发出任何消息。详见[沙箱模式](/zh/docs/sandbox-mode)。

## Webhooks

**Webhooks** 是 EffiLink 在邮件事件发生时（例如投递、打开、点击、退信、退订）向您的端点发送的 HTTP 回调。您可以在 **EffiLink\_控制台\_**或通过 ***Webhook 配置 API*** 设置 ***webhook URL***。 **Webhooks** 是 EffiLink 在邮件事件发生时（例如投递、打开、点击、退信、退订）向您的端点发送的 HTTP 回调。您可以在 **EffiLink 控制台**或通过 **Webhook 配置 API** 设置 **Webhook URL**。

## API 版本

本文档涵盖 **API v5**，是当前推荐使用的版本。所有 v5 端点的基础路径为 `/v5/`。如果您现有集成使用的是更早版本，建议迁移至 v5 以获得最新功能与最佳性能。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.