获取已授权的 TTO Creator Marketplace 账户
你可以使用本接口获取已授权你的开发者应用的 TikTok One(TTO)Creator Marketplace 账户列表。
注意
如需获取授权了你的开发者应用的用户的信息,可使用接口 /user/info/。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/tto/oauth2/tcm/
方法 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%}|
|--- |--- |--- |
| app_id {必填} | string | 开发者应用 ID。 <br><br>要查找 <strong>App ID</strong>,请进入 <strong>[我的应用](https://ads.tiktok.com/marketing_api/apps/)</strong> > <strong>应用详情</strong> > <strong>基本信息</strong>。 |
| secret {必填} | string | 您的开发者应用密钥。 <br><br>要查找 <strong>密钥</strong>,请进入 <strong>[我的应用](https://ads.tiktok.com/marketing_api/apps/)</strong> > <strong>应用详情</strong> > <strong>基本信息</strong>。 |
示例
(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/tto/oauth2/tcm/?app_id={{app_id}}&secret={{secret}}' \
--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|返回数据。|
#|tto_tcm_account_ids | string[]|已授权开发者应用 `app_id` 的 TikTok One Creator Marketplace 账户 ID 列表。|
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"tto_tcm_account_ids": [
"{{tto_tcm_account_id}}"
]
}
}
(/code)