Post Results 接口
按目标账号查看发布成功或失败记录。
Post Results 聚合了每个目标账号的成功发布事件与失败记录,可用于仪表盘、重试 和用户状态展示。
接口列表
- GET
/api/v1/post-results— 支持 post/platform 过滤的结果列表。 - GET
/api/v1/post-results/{id}— 获取单条结果。
GET /api/v1/post-results
查询参数:
offset,limit— 合并成功与失败后再做分页。post_id— 帖子 ID 数组。platform— 平台 ID 数组(twitter-x、instagram、linkedin、facebook-page、tiktok、youtube、bluesky、threads、pinterest)。
响应:
{
"data": [
{
"id": "result-uuid",
"post_id": "post-uuid",
"success": true,
"social_account_id": "acc-123",
"platform_data": {
"id": "platform-owned-id",
"url": "https://platform.com/post/123",
"username": "syncpostly"
},
"error": null
}
],
"meta": { "offset": 0, "limit": 10, "total": 4 }
}失败记录会设置 success: false、url: null,并包含 error:
{
"error": {
"code": "API_RATE_LIMIT",
"message": "Rate limit exceeded",
"context": { /* provider-specific */ }
}
}结果按事件时间倒序,再进行分页。
示例:
curl "https://<host>/api/v1/post-results?post_id=post-uuid&platform=linkedin" \
-H "Authorization: Bearer YOUR_SECRET_TOKEN"GET /api/v1/post-results/{id}
路径参数:id。返回成功或失败记录;不属于当前工作区则 404。
备注
- 某些极少数情况下无法关联到具体账号时,
social_account_id可能为 null。 - 成功记录会在可用时提供平台 URL,便于跳转到真实帖子。
