跳转到主要内容
GET
Beta。 请参见自动化概述获取完整的功能描述。
返回该自动化的每次派发尝试,按最新在前的顺序排列。每一行记录收件人、命中的触发器、每个动作的结果,以及任何错误。 会返回近 30 天的条目。更早的条目仍存在于 Firestore(出于分析用途,保留时间为无限期),但出于性能原因不在该端点中返回。

活动条目状态

每一行都有顶层的 status,以及 actionResults[] 内每个动作的 status
状态记录时机
pending条目刚被写入;工作程序尚未开始处理
in_flight工作程序当前正在派发
sent每个动作都成功
failed至少一个动作失败(并且没有命中鉴权错误)
auth_errorInstagram 访问令牌无效;私信不会被重试
rate_limited达到每日私信上限(套餐或每资料)。未发送私信
deduplicated该动作在其去重窗口内(默认 7 天,可按动作配置)已向此收件人触发过
skipped在扇出与派发之间,该自动化变为非活跃或已被删除
pendingin_flight 为过渡状态;其他都为终态。

请求头参数

路径参数

id
string
必填
POST /automations 返回的自动化 ID。

查询参数

limit
number
默认值:25
分页大小。默认 25,最大 100。范围外的值会被截断到 [1, 100];非整数或 ≤0 返回 HTTP 400。
next
string
上一次响应中 meta.pagination.next 的不透明游标。首次请求时省略即可。仅支持向前——传递 ?previous= 会返回 HTTP 400。

响应结构

响应将结果列表包裹在 activity[] 中,游标信息包裹在 meta.pagination 中:
meta.pagination.next 是一段 Base64 编码的不透明数据——将其视为黑盒,并在下一次请求的 ?next= 中原样传回。当至少还有一页时,meta.pagination.hasMoretrue