如何将数据来源连接到您自己的 API
最后更新
通过连接的 API 数据来源,当订阅者的电子邮件被打开时,Sendtric 会调用您的 API 以获取其数据。由于没有任何数据会被复制到 Sendtric 中,因此图片显示的内容完全取决于您的 API 在该时刻返回的结果,例如实时订单状态或当天的账户余额。
如果您希望提前将数据推送到 Sendtric,请参阅如何使用 Sendtric API 发送记录.
您的 API 需要什么
- 一个HTTPS URL,该URL可通过公共互联网访问。
- 一种通过标识符(位于路径中或作为查询参数)来获取一条记录的方法。例如
https://api.example.com/customers/12345. - A JSON响应,其中包含该记录的字段,例如
{"first_name": "Sarah", "points": 1250}. - 简要回复:Sendtric 最多等待 5 秒,且响应大小必须小于 1 MB。
设置好它
- 在左侧边栏中,点击数据来源,然后新建数据来源.
- Under API下,选择API,然后点击继续.
- 选择从 API 获取数据,然后点击继续.
- 请填写数据源名称,唯一标识符字段(例如
customer_id),并可根据需要填写描述. - 选择方法: GET或POST.
- 输入您的 API URL,并将
{{uid}}标识符,例如https://api.example.com/customers/{{uid}}。Sendtric 会将{{uid}}替换为每位订阅者的标识符。 - 添加任何标头,例如
Authorization并附上您的 API 令牌。点击+ 添加。 - 添加任意查询参数。如果您的 API 将标识符作为参数,请将
{{uid}}其值,而不是 URL,例如id={{uid}}. - 请在测试唯一标识符值中,并点击测试 API.
- 查看响应,然后单击保存数据来源.

保存数据来源该选项将保持禁用状态,直到测试成功且响应中包含至少一个字段为止。如果您更改了 URL、方法、请求头或参数,请重新进行测试。
请使用测试端点或专用的只读 API 令牌。Sendtric 会在保存后将标头值保密,因此若要修改该值,您需要重新输入。
查找功能的工作原理
- 每次查询都会向您的 API 发送一个请求,以获取一位订阅者的信息。
- 标识符会完全按照合并标签中填入的内容发送,因此如果您的 API 区分大小写,则大小写会产生影响。
- Sendtric 会为缓存时间(2 至 60 分钟)内,因此重复打开时不会每次都调用您的 API。
- 如果您的 API 响应缓慢、返回错误或该标识符无记录,则该值将被视为空值。在个性化图片中,该图层会被隐藏,因此请设计图片,确保即使没有该图层,图片仍能呈现正常效果。
更改连接
在数据来源中,单击数据来源以打开其设置。您可以修改 URL、请求方法、请求头和参数,然后运行测试 API。
下一步
这篇文章对你有帮助吗?
感谢你的反馈!
