Lấy thông tin tài khoản trước khi đăng (tên, ảnh, mức hiển thị, độ dài tối đa)

Query Creator Info

POST/v2/post/publish/creator_info/query/Gọi qua 360: POST https://partner.quantri360.com/v1/tiktok_business/v2/post/publish/creator_info/query/

Mô tả API

Thông tin tài khoản TikTok trước khi đăng: tên, ảnh đại diện, các mức hiển thị được chọn, tài khoản có tắt bình luận / Duet / Stitch không, độ dài video tối đa. Gọi trước mỗi lần đăng và hiển thị cho người dùng chọn.

Không có tham số — tài khoản lấy theo platform_shop_id.

Request

Địa chỉ

POST https://partner.quantri360.com/v1/tiktok_business/v2/post/publish/creator_info/query/

Xác thực & gian hàng

Tên	Vị trí	Kiểu	Mẫu	Mô tả
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.

Tham số request

Không có tham số riêng (ngoài tham số chung).

Ví dụ request

curl -s -X POST "https://partner.quantri360.com/v1/tiktok_business/v2/post/publish/creator_info/query/?platform_shop_id=-000AbCdEfGhIjKlMnOpQrStUvWxYz012345" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Python

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.post(
    "https://partner.quantri360.com/v1/tiktok_business/v2/post/publish/creator_info/query/",
    params={
        "platform_shop_id": "-000AbCdEfGhIjKlMnOpQrStUvWxYz012345"
    },
    json={},
    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/v2/post/publish/creator_info/query/');
for (const [k, v] of Object.entries({"platform_shop_id":"-000AbCdEfGhIjKlMnOpQrStUvWxYz012345"})) 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({}),
});
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/v2/post/publish/creator_info/query/' . '?' . http_build_query(['platform_shop_id' => '-000AbCdEfGhIjKlMnOpQrStUvWxYz012345']);
$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, '{}');
$res = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $res;

Response

Tham số phản hồi (nguyên của TikTok Business)

Tên	Kiểu	Mẫu	Mô tả
data	object		Dữ liệu.
creator_nickname	string	Quantri360	Tên hiển thị.
creator_username	string	quantri360	Tên người dùng (@).
creator_avatar_url	string		Ảnh đại diện — link tạm, có hạn.
privacy_level_options	string[]	["PUBLIC_TO_EVERYONE","MUTUAL_FOLLOW_FRIENDS","SELF_ONLY"]	Mức hiển thị được chọn. Tài khoản riêng tư có `FOLLOWER_OF_CREATOR` thay cho `PUBLIC_TO_EVERYONE`.
comment_disabled	bool	false	`true` = tài khoản đã tắt bình luận, không bật được khi đăng.
duet_disabled	bool	false	Tương tự cho Duet.
stitch_disabled	bool	false	Tương tự cho Stitch.
max_video_post_duration_sec	int	3600	Độ dài video tối đa (giây).
error	object		Kết quả: `code = "ok"` là thành công, khác "ok" là lỗi (xem `message`).
code	string	ok	Mã kết quả.
message	string		Mô tả lỗi.
log_id	string	202610261729…	Mã nhật ký của TikTok, gửi kèm khi cần hỗ trợ.

Bắt đầu dùng

Đăng ký tài khoản Partner
Mở loại dữ liệu thuộc nhóm Tài khoản TikTok (Organic API) ở trang nền tảng
Tạo API key (tick kênh TikTok Business)
Gọi theo ví dụ ở trên

Lấy thông tin tài khoản trước khi đăng (tên, ảnh, mức hiển thị, độ dài tối đa) — API TikTok Business