数据来源与API

如何将数据来源连接到您自己的 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。

设置好它

  1. 在左侧边栏中,点击数据来源,然后新建数据来源.
  2. Under API下,选择API,然后点击继续.
  3. 选择从 API 获取数据,然后点击继续.
  4. 请填写数据源名称,唯一标识符字段(例如customer_id),并可根据需要填写描述.
  5. 选择方法: GET或POST.
  6. 输入您的 API URL,并将{{uid}}标识符,例如https://api.example.com/customers/{{uid}}。Sendtric 会将{{uid}}替换为每位订阅者的标识符。
  7. 添加任何标头,例如Authorization并附上您的 API 令牌。点击+ 添加。
  8. 添加任意查询参数。如果您的 API 将标识符作为参数,请将{{uid}}其值,而不是 URL,例如id = {{uid}}.
  9. 请在测试唯一标识符值中,并点击测试 API.
  10. 查看响应,然后单击保存数据来源.
“从 API 获取数据”设置:URL 中包含 {{uid}}、Authorization 头、测试值以及成功的测试响应

保存数据来源该选项将保持禁用状态,直到测试成功且响应中包含至少一个字段为止。如果您更改了 URL、方法、请求头或参数,请重新进行测试。

请使用测试端点或专用的只读 API 令牌。Sendtric 会在保存后将标头值保密,因此若要修改该值,您需要重新输入。

查找功能的工作原理

  • 每次查询都会向您的 API 发送一个请求,以获取一位订阅者的信息。
  • 标识符会完全按照合并标签中填入的内容发送,因此如果您的 API 区分大小写,则大小写会产生影响。
  • Sendtric 会为缓存时间(2 至 60 分钟)内,因此重复打开时不会每次都调用您的 API。
  • 如果您的 API 响应缓慢、返回错误或该标识符无记录,则该值将被视为空值。在个性化图片中,该图层会被隐藏,因此请设计图片,确保即使没有该图层,图片仍能呈现正常效果。

更改连接

在数据来源中,单击数据来源以打开其设置。您可以修改 URL、请求方法、请求头和参数,然后运行测试 API。

下一步

这篇文章对你有帮助吗?

点击图片即可放大,拖动或滚动可查看其他区域。