获取 TikTok 帖子的发布状态

您可以使用本接口获取单个 TikTok 视频帖子或照片帖子的发布状态。

使用前需知

您需先使用 /business/video/publish/ 或 /business/photo/publish/ 生成一个帖子发布任务并从返回中获取share_id。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/business/publish/status/

方法 GET

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|经 TikTok 创作者授权的访问令牌。<br>若想获取访问令牌，需使用[/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs?id=1738084387220481#item-link-%E8%8E%B7%E5%8F%96%20TikTok%20%E8%B4%A6%E5%8F%B7%E8%AE%BF%E9%97%AE%E4%BB%A4%E7%89%8C)接口。|

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|business_id {必填}| string |TikTok 账户的应用唯一识别 ID。<br><br>您需将[/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs?id=1738084387220481#item-link-%E8%8E%B7%E5%8F%96%20TikTok%20%E8%B4%A6%E5%8F%B7%E8%AE%BF%E9%97%AE%E4%BB%A4%E7%89%8C)接口返回的`open_id`字段值传给本字段。|
| publish_id {必填} | string | 帖子发布任务的唯一标识符。 <br><br>您需将[/business/video/publish/](1762228496095234.html)或[/business/photo/publish](1803630424390658.html)接口返回的`share_id`字段值传给本字段。 |

示例

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/business/publish/status/?business_id={{business_id}}&publish_id={{publish_id}}' \
--header 'Access-Token: {{Access-Token}}'
(/code)

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number| 返回码。完整返回码列表及描述，参见 [附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string| 返回信息。更多信息参见 [附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。 |
|request_id |string| 请求的日志ID，唯一标识一个请求。 |
|data |object| 返回数据。 |
#| status | string | TikTok 帖子的发布状态。<br><br>枚举值： <ul><li> `PROCESSING_DOWNLOAD`：正在从 URL 中提取内容。</li><li>`PUBLISH_COMPLETE`：帖子已通过审核且发布成功。</li><li>`FAILED`：帖子发布出现错误，帖子发布失败。</li><li>`SEND_TO_USER_INBOX`：帖子草稿上传成功，系统已将相应通知发至创作者的收件箱中。</li></ul>|
#| post_ids | string[] | 仅当 `status` 为 `PUBLISH_COMPLETE` 且帖子公开可见时返回本字段。  <br><br>发布的 TikTok 帖子的 ID 列表。 <br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>帖子 ID 的数据处理可能长达 3 分钟。若未直接返回帖子 ID ，需等待 3 分钟后重试。</li><li>您可将本字段返回的 ID 列表传入[/business/video/list/](1762228421622786.html)中的筛选字段`video_ids`，从而获取这些帖子的指标数据。</li></ul> |
#| reason | string | 仅当 `status` 为 `FAILED` 时返回本字段。 <br><br>发布失败的原因。 <br><br> 示例： `frame_rate_check_failed`。<br><br>若想获取失败原因的具体描述，可查看[失败原因](https://business-api.tiktok.com/portal/docs?id=1810515090228226#item-link-%E5%A4%B1%E8%B4%A5%E5%8E%9F%E5%9B%A0)。 |

示例

发布成功的帖子

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "post_ids": [
            "{{post_id}}"
        ],
        "status": "PUBLISH_COMPLETE"
    }
}
(/code)

发布失败的帖子

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "reason": "frame_rate_check_failed",
        "status": "FAILED"
    }
}
(/code)