VI | EN
Nhắn Messenger
Dành cho developer

Lấy trạng thái đăng theo publish_id — API TikTok Business

Get Post Status · gọi qua Quantri360 bằng một API key cho chính tài khoản / tài sản bạn đã kết nối và ủy quyền — 360 lo việc ký request và làm mới phiên đăng nhập bạn đã cấp.

Get Post Status

POST/v2/post/publish/status/fetch/Gọi qua 360: POST https://partner.quantri360.com/v1/tiktok_business/v2/post/publish/status/fetch/
Mô tả API

Trạng thái của một lượt đăng theo publish_id.

  • Hỏi lại mỗi 5–10 giây tới khi xong; TikTok có thể mất vài phút với video lớn.

Request

Địa chỉ

POST https://partner.quantri360.com/v1/tiktok_business/v2/post/publish/status/fetch/

Xác thực & gian hàng

TênVị tríKiểuMẫuMô tả
AuthorizationheaderheaderBearer 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_idquerystring7000000000000000001Tà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

TênVị tríKiểuBắt buộcMẫuMô tả
publish_idbodystringCóv_inbox_file~v2.123456789publish_id trả về khi mở phiên đăng.

Ví dụ request

curl -s -X POST "https://partner.quantri360.com/v1/tiktok_business/v2/post/publish/status/fetch/?platform_shop_id=-000AbCdEfGhIjKlMnOpQrStUvWxYz012345" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"publish_id":"v_inbox_file~v2.123456789"}'
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/status/fetch/",
    params={
        "platform_shop_id": "-000AbCdEfGhIjKlMnOpQrStUvWxYz012345"
    },
    json={
        "publish_id": "v_inbox_file~v2.123456789"
    },
    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/status/fetch/');
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({"publish_id":"v_inbox_file~v2.123456789"}),
});
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/status/fetch/' . '?' . 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, '{"publish_id":"v_inbox_file~v2.123456789"}');
$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ênKiểuMẫuMô tả
dataobjectDữ liệu.
statusstringSEND_TO_USER_INBOX`PROCESSING_UPLOAD` (đang nhận file) · `PROCESSING_DOWNLOAD` · `SEND_TO_USER_INBOX` (đã vào bản nháp) · `PUBLISH_COMPLETE` (đã đăng) · `FAILED`.
fail_reasonstringframe_rate_check_failedLý do khi `FAILED`.
uploaded_bytesint26045680Số byte TikTok đã nhận.
publicaly_available_post_idstring[]Id bài đã đăng công khai (khi có).
errorobjectKết quả: `code = "ok"` là thành công, khác "ok" là lỗi (xem `message`).
codestringokMã kết quả.
messagestringMô tả lỗi.
log_idstring202610261729…Mã nhật ký của TikTok, gửi kèm khi cần hỗ trợ.

Bắt đầu dùng

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