跳转到主要内容
GET
Beta。 完整功能說明請見自動化概觀
回傳單一自動化的每一次派送嘗試,最新的在最前面。每一列都會記錄接收者、比對到的觸發條件、每個動作的結果,以及任何錯誤。 僅回傳最近 30 天內的資料列。較舊的資料列仍存在於 Firestore 中(用於分析的保留為無限期),但此端點為了效能而排除這些資料。

活動列狀態

每一列都有最外層的 status,以及 actionResults[] 中每個動作的 status
狀態何時記錄
pending資料列剛寫入,Worker 尚未取用
in_flightWorker 正在派送中
sent所有動作都成功
failed至少一個動作失敗(且沒有動作發生驗證錯誤)
auth_errorInstagram 存取權杖無效;DM 沒有被重試
rate_limited已達每日 DM 上限(方案層級或每個個人檔案)。DM 未被發送
deduplicated此動作已於去重視窗內對此接收者觸發過(預設 7 天,可依動作個別設定)
skipped在 fan-out 與派送之間,該自動化被停用或已刪除
pendingin_flight 為暫時狀態;其他皆為終態。

標頭參數

路徑參數

id
string
必填
POST /automations 回傳的自動化 ID。

查詢參數

limit
number
默认值:25
每頁大小。預設 25,最大 100[1, 100] 以外的值會被夾限(clamp);非整數或 ≤0 會回傳 HTTP 400。
next
string
來自上一次回應 meta.pagination.next 的不透明游標。第一次請求時省略。僅支援向前分頁 — 傳入 ?previous= 會回傳 HTTP 400。

回應格式

回應會將結果清單包在 activity[] 中,並將游標資訊包在 meta.pagination 中:
meta.pagination.next 是 base64 編碼的不透明字串 — 請將其視為黑盒,並在下一次請求的 ?next= 中原樣傳回。當至少還有一頁時,meta.pagination.hasMoretrue