Apply an authorization code
POST/tt_video/authorize/Via 360: POST https://partner.quantri360.com/v1/tiktok_business/tt_video/authorize/
Write endpoint — changes data on TikTok Business. The key must be created with "Allow write API calls" ticked, otherwise you get 403 write_not_allowed. Every call is logged.
Description
Use this endpoint to apply an authorization code. After you get the authorization code from the post owner, the authorization is not automatically in effect. You need to apply the code to connect the ad account with the Spark Ads post.
If a post is a duet or stitch from another post or it mentions another video, you need to get authorization from the owners of both posts before you can promote the post. Use auth_code to specify the authorization code for the post, and use original_post_auth_code to specify the authorization code for the original post.
Request
Endpoint
POST https://partner.quantri360.com/v1/tiktok_business/tt_video/authorize/
Authentication & shop
| Name | In | Type | Sample | Description |
|---|---|---|---|---|
| Authorization | header | header | Bearer q360_live_ab12cd34_… | Khóa API của brand (tạo ở mục API key). Bắt buộc với mọi request. Brand suy từ key — không truyền mã brand. |
| platform_shop_id | query | string | 7000000000000000001 | Tài sản TikTok Business đã kết nối — "Mã tài sản" ở trang Nền tảng hoặc GET /v1/platforms (tài khoản quảng cáo cho Marketing API, tài khoản TikTok cho Organic / Messaging). Có thể bỏ khi chỉ kết nối một tài sản. |
Request parameters
| Name | In | Type | Required | Sample | Description |
|---|---|---|---|---|---|
| auth_code | body | string | Yes | The authorization code for the Spark Ads post. Note: Replace "+" in your authorization code with "%2B". Otherwise, you may get an invalid authorization code error. For example, you can replace the "+" in the code "#XtjblzbEuOGK/BvHj4V/K0i71JL3Wu2fgRtOJrZSSf4SrPAedegtn+IH+UXr3f4=" and specify "#XtjblzbEuOGK/BvHj4V/K0i71JL3Wu2fgRtOJrZSSf4SrPAedegtn%2BIH%2BUXr3f4=". | |
| original_post_auth_code | body | string | No | If this post is a duet or stitch from another post or it mentions another video, you also need to get the authorization code for the original post. Use this field to specify the authorization code for the original post. Note: Currently, the post can only mention at most one video. |
Request examples
curl -s -X POST "https://partner.quantri360.com/v1/tiktok_business/tt_video/authorize/" \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: application/json" \
-d '{"auth_code":""}'
Python
import requests
KEY = "q360_live_..." # khóa API của brand
r = requests.post(
"https://partner.quantri360.com/v1/tiktok_business/tt_video/authorize/",
params={},
json={
"auth_code": ""
},
headers={"Authorization": f"Bearer {KEY}"},
timeout=60,
)
print(r.status_code)
print(r.json())Node.js
const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/tiktok_business/tt_video/authorize/');
for (const [k, v] of Object.entries({})) url.searchParams.set(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
const r = await fetch(url, {
method: 'POST',
headers: { Authorization: `Bearer ${KEY}`, 'Content-Type': 'application/json' },
body: JSON.stringify({"auth_code":""}),
});
console.log(r.status, await r.json());PHP
<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/tiktok_business/tt_video/authorize/' . '?' . http_build_query([]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key, 'Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"auth_code":""}');
$res = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $res;Response
Response fields (as returned by TikTok Business)
| Name | Type | Sample | Description |
|---|---|---|---|
| message | string | The return message. For details, see Appendix - Return Codes. | |
| code | number | The return code. For the complete list of error codes and descriptions, see Appendix - Return Codes. | |
| data | object | The returned data | |
| request_id | string | The unique log ID of the request. |
Response sample
HTTPS/1.1 200 OK
{
"message": "OK",
"code": 0,
"data": {}
}
(/code);
Get started
- Sign up for Partner
- Enable a data type of the Ads (Marketing API) group on the platform page
- Create an API key (tick the TikTok Business channel)
- Call it as in the examples above