检查 TTO 达人状态

你可以使用本接口可检查 TikTok 用户是否已成为 TikTok One（TTO）达人。

你可通过传入 tto_tcm_account_id 和 handle_names 同时查询最多 20 位用户的状态。

请求

接口 https://business-api.tiktok.com/open_api/v1.3/tto/tcm/creator/status/get/

方法 GET

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token  {必填}|string|由 TTO Creator Marketplace账户授权的访问令牌。<br>详情参见[从 TTO Creator Marketplace 账户获取授权和访问令牌](https://business-api.tiktok.com/portal/docs/obtain-authorization-and-authentication-from-a-tto-creator-marketplace-account/v1.3)。|

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
| tto_tcm_account_id {Required} | string | TTO Creator Marketplace 账户的 ID。<br><br>如需获取您可通过 `Access-Token` 访问的账户 ID，请使用 [/tto/oauth2/tcm/](1815693478150146.html) 接口。 |
| handle_names {Required} | string[] | TikTok 达人的用户名。<br><br>最大数量：20。|

示例

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/tto/tcm/creator/status/get/?tto_tcm_account_id={{tto_tcm_account_id}}&handle_names=["{{handle_name}}","{{handle_name}}","{{handle_name}}"]' \
--header 'Access-Token: {{Access-Token}}'
(/code)

返回

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number|返回码。完整返回码列表及描述参见[附录 - 返回码](1737172488964097.html)。<br><span style="color:darkred"><b>注意</b></span>：此字段适用于所有用于创建问题报告和排查的 API 请求。|
|message |string|返回信息。更多信息参见[附录 - 返回码](1737172488964097.html)。|
|request_id|string|请求的日志 ID，唯一标识一个请求。|
|data |object|返回数据。|
#|onboarding_status |object[]|达人的入驻状态数据。|
##|handle_name |string|被检查的用户名。|
##|status |string|该达人的入驻状态。<br>枚举值：<ul><li>`IN`：该达人已加入 TTO Creator Marketplace。</li><li>`NOT_IN`：该达人尚未加入 TTO Creator Marketplace。</li><li>`INVALID`：指定的用户名（`handle_name`）无效。</li></ul>|

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "onboarding_status": [
            {
                "handle_name": "{{handle_name}}",
                "status": "NOT_IN"
            },
            {
                "handle_name": "{{handle_name}}",
                "status": "IN"
            },
            {
                "handle_name": "{{handle_name}}",
                "status": "INVALID"
            }
        ]
    }
}
(/code)