ΣύνδεσηΞεκινήστε δωρεάν δοκιμή
easyCoexistence Επίσημα API

Το TikTok API σε Python και Node.js: λειτουργικά παραδείγματα

Το TikTok API for Business λειτουργεί από Python ή Node.js με απλά αιτήματα HTTPS: στείλτε κάθε κλήση στο https://business-api.tiktok.com/open_api/v1.3 με το token του λογαριασμού στην κεφαλίδα Access-Token και το open_id του ως business_id. Το TikTok απαντά στις περισσότερες κλήσεις με HTTP 200 και πεδίο code, όπου το 0 σημαίνει επιτυχία. Ελέγξτε το code και περιμένετε 5 λεπτά όταν εμφανιστεί το 40100.

Το easyCoexistence δίνει στο Claude, στο ChatGPT ή στον δικό σας κώδικα τις ίδιες εργασίες TikTok ως εργαλεία, από το publish_tiktok_post και το reply_to_comment έως το get_social_insights, και παραδίδει στα σενάρια σας ένα τρέχον token μέσω του get_social_credentials ή του Partner API.

HTTP 200

Κατάσταση της πλειονότητας των απαντήσεων του TikTok, σφάλματα συμπεριλαμβανομένων· μόνο code 0 στο σώμα σημαίνει ότι η κλήση πέτυχε.

40100

Κωδικός για κλήση που περιορίστηκε: το TikTok ζητά παύση 5 λεπτών μετά από όριο ανά λεπτό και αναμονή έως τις 00:00 UTC μετά από ημερήσιο όριο.

5xx

Σφάλματα διακομιστή, μετά από τα οποία το TikTok προτείνει αναμονή περίπου 5 λεπτών πριν από νέα κλήση.

Final /

Οι διαδρομές τελειώνουν με κάθετο· το TikTok αναφέρει το /tt_user/oauth2/refresh_token χωρίς αυτήν ως αιτία του σφάλματος 404 page not found.

3 languages

Python, JavaScript και Java στο SDK του TikTok για το API for Business, του οποίου η λίστα endpoints δεν περιλαμβάνει κανένα endpoint /business/.

HMAC-SHA256

Υπογραφή στην κεφαλίδα Tiktok-Signature κάθε webhook, υπολογισμένη στο timestamp, μια τελεία και το σώμα, με κλειδί το app secret.

Τι χρειάζεται κάθε κλήση στο TikTok API;

Τα ίδια πέντε στοιχεία, όποια κι αν είναι η εργασία:

  • Η βασική διεύθυνση https://business-api.tiktok.com/open_api/v1.3, με διαδρομή που τελειώνει σε κάθετο, όπως /business/video/list/.
  • Το access token του λογαριασμού στην κεφαλίδα Access-Token, ανανεωμένο πριν λήξουν οι 24 ώρες του.
  • Το business_id, δηλαδή το open_id του λογαριασμού: στη συμβολοσειρά ερωτήματος στο GET, στο σώμα JSON στο POST.
  • Παράμετροι λίστας και αντικειμένων στο GET, όπως fields και filters, στάλμενες ως κείμενο JSON: fields=["item_id","caption"].
  • Έλεγχος του code στην απάντηση, αφού το TikTok στέλνει σφάλματα όπως 40002 ή 40100 με HTTP 200 και δεδομένα μόνο όταν το code είναι 0.

Πώς χειρίζεστε τη δομή σφάλματος του TikTok σε Python;

Με έναν μικρό client που βάζει το business_id εκεί που το ζητά κάθε μέθοδος, επιστρέφει δεδομένα όταν το code είναι 0 και πετάει ένα TikTokError σε κάθε άλλη περίπτωση. Επαναλαμβάνει την κλήση που περιορίστηκε μετά την παύση 5 λεπτών του TikTok, αφού το 40100 σημαίνει ότι το TikTok απέρριψε την κλήση, και επαναλαμβάνει σφάλμα 5xx μόνο στο GET, επειδή μια δημοσίευση που κατέληξε σε σφάλμα διακομιστή μπορεί να έφτασε ήδη στο TikTok. Χρειάζεται το requests, και τα επόμενα παραδείγματα Python το επαναχρησιμοποιούν:

Python: a TikTok client that reads the envelope
import json
import os
import time

import requests

API = "https://business-api.tiktok.com/open_api/v1.3"


class TikTokError(Exception):
    def __init__(self, code, message, request_id):
        super().__init__(f"TikTok {code}: {message} (request_id {request_id})")
        self.code = code


class TikTok:
    """One TikTok account: its access token and its business_id, the open_id."""

    def __init__(self, access_token, business_id, pause=300):
        self.http = requests.Session()
        self.http.headers["Access-Token"] = access_token
        self.business_id = business_id
        self.pause = pause  # TikTok's advice after a 40100 or a 5xx: about 5 minutes

    def call(self, method, path, params=None, body=None, tries=3):
        for attempt in range(1, tries + 1):
            if method == "GET":
                query = {"business_id": self.business_id}
                for key, value in (params or {}).items():
                    is_json = isinstance(value, (list, dict))
                    query[key] = json.dumps(value, separators=(",", ":")) if is_json else value
                res = self.http.get(f"{API}/{path}", params=query, timeout=30)
            else:
                payload = {"business_id": self.business_id, **(body or {})}
                res = self.http.post(f"{API}/{path}", json=payload, timeout=30)
            if res.status_code >= 500 and method == "GET" and attempt < tries:
                time.sleep(self.pause)  # a POST is not repeated: it may have reached TikTok
                continue
            res.raise_for_status()  # a 4xx: a wrong path or method, such as a missing final slash
            answer = res.json()
            if answer.get("code") == 0:
                return answer.get("data") or {}
            if answer.get("code") == 40100 and attempt < tries:
                time.sleep(self.pause)  # throttled: TikTok refused the call, so repeating it is safe
                continue
            raise TikTokError(answer.get("code"), answer.get("message"), answer.get("request_id"))


tt = TikTok(os.environ["TIKTOK_ACCESS_TOKEN"], os.environ["TIKTOK_BUSINESS_ID"])

Και πώς τη χειρίζεστε σε Node.js;

Ο ίδιος client πάνω στο fetch που είναι ενσωματωμένο στο Node.js 18 και νεότερα, χωρίς να χρειάζεται εγκατάσταση. Κωδικοποιεί τις παραμέτρους λίστας ως JSON στο GET, βάζει το business_id στο σώμα στο POST και κρατά τον code του TikTok στο σφάλμα, ώστε οι καλούντες να ξεχωρίζουν το 40102 ή 40105, πρόβλημα token, από το 40001, δηλαδή ελλείπον δικαίωμα:

Node.js: the same client on the built-in fetch
const API = "https://business-api.tiktok.com/open_api/v1.3";
const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

class TikTokError extends Error {
  constructor(code, message, requestId) {
    super("TikTok " + code + ": " + message + " (request_id " + requestId + ")");
    this.code = code;
  }
}

// One TikTok account: its access token and its business_id, the open_id.
class TikTok {
  constructor(accessToken, businessId, pauseMs = 300000) {
    this.accessToken = accessToken;
    this.businessId = businessId;
    this.pauseMs = pauseMs; // TikTok's advice after a 40100 or a 5xx: about 5 minutes
  }

  async call(method, path, { params = {}, body = {} } = {}, tries = 3) {
    for (let attempt = 1; ; attempt++) {
      const url = new URL(API + "/" + path);
      const init = { method, headers: { "Access-Token": this.accessToken } };
      if (method === "GET") {
        url.searchParams.set("business_id", this.businessId);
        for (const [key, value] of Object.entries(params)) {
          url.searchParams.set(key, typeof value === "object" ? JSON.stringify(value) : String(value));
        }
      } else {
        init.headers["Content-Type"] = "application/json";
        init.body = JSON.stringify({ business_id: this.businessId, ...body });
      }
      const res = await fetch(url, init);
      if (res.status >= 500 && method === "GET" && attempt < tries) {
        await sleep(this.pauseMs); // a POST is not repeated: it may have reached TikTok
        continue;
      }
      if (!res.ok) throw new Error("HTTP " + res.status + " on " + path + ": check the path, its final slash and the method");
      const answer = await res.json();
      if (answer.code === 0) return answer.data ?? {};
      if (answer.code === 40100 && attempt < tries) {
        await sleep(this.pauseMs); // throttled: TikTok refused the call, so repeating it is safe
        continue;
      }
      throw new TikTokError(answer.code, answer.message, answer.request_id);
    }
  }
}

const tt = new TikTok(process.env.TIKTOK_ACCESS_TOKEN, process.env.TIKTOK_BUSINESS_ID);

Πώς δημοσιεύετε βίντεο με URL και ελέγχετε την κατάστασή του;

POST στο /business/video/publish/ με video_url και post_info, και στη συνέχεια ελέγχετε με επαναλαμβανόμενα αιτήματα το /business/publish/status/ με το share_id ως publish_id. Ο βρόχος σταματά στο FAILED με τον λόγο του TikTok, ενώ στο PUBLISH_COMPLETE συνεχίζει να περιμένει μέχρι να εμφανιστεί το post_ids, κάτι που, σύμφωνα με το TikTok, μπορεί να διαρκέσει έως τρία λεπτά ακόμη. Το video_url πρέπει να βρίσκεται σε τομέα ή πρόθεμα URL επαληθευμένο για την εφαρμογή σας:

Publish a video and wait until it is public: Python, then Node.js
# Python
def wait_until_live(tt, share_id, interval=30, give_up_after=7200):
    deadline = time.time() + give_up_after
    while time.time() < deadline:
        status = tt.call("GET", "business/publish/status/", params={"publish_id": share_id})
        if status["status"] == "FAILED":
            raise RuntimeError(f"TikTok did not publish {share_id}: {status.get('reason')}")
        if status["status"] == "PUBLISH_COMPLETE" and status.get("post_ids"):
            return status["post_ids"]
        time.sleep(interval)  # post_ids can follow PUBLISH_COMPLETE by up to three minutes
    raise TimeoutError(f"{share_id} was not public after {give_up_after} s")


video = tt.call("POST", "business/video/publish/", body={
    "video_url": "https://media.example.com/tiktok/launch.mp4",  # on a verified domain or URL prefix
    "post_info": {
        "caption": "Our spring menu is live #food",
        "is_brand_organic": True,  # the Promotional content label, for the account's own business
        "is_branded_content": False,
    },
})
print("Live:", wait_until_live(tt, video["share_id"]))

// Node.js
async function waitUntilLive(tt, shareId, everyMs = 30000, giveUpAfterMs = 7200000) {
  const deadline = Date.now() + giveUpAfterMs;
  while (Date.now() < deadline) {
    const s = await tt.call("GET", "business/publish/status/", { params: { publish_id: shareId } });
    if (s.status === "FAILED") throw new Error("TikTok did not publish " + shareId + ": " + s.reason);
    if (s.status === "PUBLISH_COMPLETE" && s.post_ids && s.post_ids.length) return s.post_ids;
    await sleep(everyMs); // post_ids can follow PUBLISH_COMPLETE by up to three minutes
  }
  throw new Error(shareId + " was not public after " + giveUpAfterMs / 1000 + " s");
}

async function publishVideo(tt) {
  const video = await tt.call("POST", "business/video/publish/", {
    body: {
      video_url: "https://media.example.com/tiktok/launch.mp4", // on a verified domain or URL prefix
      post_info: { caption: "Our spring menu is live #food", is_brand_organic: true, is_branded_content: false },
    },
  });
  return waitUntilLive(tt, video.share_id);
}

publishVideo(tt).then((postIds) => console.log("Live:", postIds), console.error);

Πώς δημοσιεύετε φωτογραφίες;

Διαβάστε πρώτα τις επιτρεπόμενες ρυθμίσεις του λογαριασμού και μετά κάντε POST στο /business/photo/publish/. Η δημοσίευση φωτογραφίας απαιτεί privacy_level, που πρέπει να είναι ένα από τα privacy_level_options του /business/video/settings/, και όταν εκεί το comment_disabled είναι true, το disable_comment πρέπει επίσης να είναι true. Το share_id που επιστρέφεται παρακολουθείται με την ίδια συνάρτηση αναμονής όπως ένα βίντεο:

Publish a photo post: Python, then Node.js
# Python
def publish_photos(tt, image_urls, title, caption):
    settings = tt.call("GET", "business/video/settings/")
    if "PUBLIC_TO_EVERYONE" not in settings["privacy_level_options"]:
        raise RuntimeError(f"Private account, choose from {settings['privacy_level_options']}")
    photo = tt.call("POST", "business/photo/publish/", body={
        "photo_images": image_urls,  # 1 to 35 JPG, JPEG or WebP links on a verified domain or prefix
        "photo_cover_index": 0,
        "post_info": {
            "title": title,  # up to 90 UTF-16 code units
            "caption": caption,  # up to 4,000
            "privacy_level": "PUBLIC_TO_EVERYONE",
            "disable_comment": settings["comment_disabled"],  # True when the account takes no comments
            "is_brand_organic": True,
            "is_branded_content": False,
        },
    })
    return wait_until_live(tt, photo["share_id"])


print(publish_photos(tt, ["https://media.example.com/menu/1.jpg", "https://media.example.com/menu/2.jpg"],
                     "Spring menu", "Four new dishes, from Friday #food"))

// Node.js
async function publishPhotos(tt, imageUrls, title, caption) {
  const settings = await tt.call("GET", "business/video/settings/");
  if (!settings.privacy_level_options.includes("PUBLIC_TO_EVERYONE")) {
    throw new Error("Private account, choose from " + settings.privacy_level_options.join(", "));
  }
  const photo = await tt.call("POST", "business/photo/publish/", {
    body: {
      photo_images: imageUrls, // 1 to 35 JPG, JPEG or WebP links on a verified domain or prefix
      photo_cover_index: 0,
      post_info: {
        title, // up to 90 UTF-16 code units
        caption, // up to 4,000
        privacy_level: "PUBLIC_TO_EVERYONE",
        disable_comment: settings.comment_disabled, // true when the account takes no comments
        is_brand_organic: true,
        is_branded_content: false,
      },
    },
  });
  return waitUntilLive(tt, photo.share_id);
}

publishPhotos(tt, ["https://media.example.com/menu/1.jpg", "https://media.example.com/menu/2.jpg"],
  "Spring menu", "Four new dishes, from Friday #food").then(console.log, console.error);

Πώς εμφανίζετε τα βίντεο ενός λογαριασμού;

GET στο /business/video/list/ με τα πεδία που θέλετε, μεταξύ των οποίων και το item_id, έως 20 αναρτήσεις ανά σελίδα, από τις νεότερες. Περάστε τον cursor που επιστρέφεται, ένα χρονικό σήμα UTC σε χιλιοστά του δευτερολέπτου, όσο το has_more είναι true, και περιμένετε μικρές σελίδες: οι κανόνες ασφαλείας του TikTok μπορεί να επιστρέψουν λιγότερα από max_count πριν τελειώσει η λίστα.

List recent videos across pages: Python, then Node.js
# Python
def recent_videos(tt, how_many=60):
    params = {"fields": ["item_id", "create_time", "caption", "share_url", "video_views", "likes", "comments"],
              "max_count": 20}
    videos = []
    while len(videos) < how_many:
        page = tt.call("GET", "business/video/list/", params=params)
        videos += page.get("videos", [])
        if not page.get("has_more"):
            break
        params["cursor"] = page["cursor"]  # posts published before this UTC time, in milliseconds
    return videos[:how_many]


for v in recent_videos(tt):
    print(v["item_id"], v.get("video_views"), (v.get("caption") or "")[:60])

// Node.js
async function recentVideos(tt, howMany = 60) {
  const params = {
    fields: ["item_id", "create_time", "caption", "share_url", "video_views", "likes", "comments"],
    max_count: 20,
  };
  const videos = [];
  while (videos.length < howMany) {
    const page = await tt.call("GET", "business/video/list/", { params });
    videos.push(...(page.videos ?? []));
    if (!page.has_more) break;
    params.cursor = page.cursor; // posts published before this UTC time, in milliseconds
  }
  return videos.slice(0, howMany);
}

recentVideos(tt).then((videos) => {
  for (const v of videos) console.log(v.item_id, v.video_views, (v.caption || "").slice(0, 60));
}, console.error);

Πώς διαβάζετε και απαντάτε σε σχόλια;

GET στο /business/comment/list/ με το item_id της ανάρτησης ως video_id επιστρέφει έως 30 σχόλια ανά σελίδα, και POST στο /business/comment/reply/create/ απαντά δημόσια σε ένα σχόλιο με έως 1.200 χαρακτήρες κειμένου. Το παράδειγμα απαντά σε δημόσια σχόλια πρώτου επιπέδου που δεν έχουν ακόμη απαντήσεις, παραλείπει αυτά του ίδιου του λογαριασμού και αφήνει τη διατύπωση σε μια συνάρτηση που γράφετε εσείς, αφού το TikTok μπορεί να κρύψει ως spam σχόλια σχεδόν ίδια που δημοσιεύονται σε μικρό χρονικό διάστημα:

Reply to new comments on a video: Python, then Node.js
# Python
def reply_to_new_comments(tt, video_id, write_reply):
    page = tt.call("GET", "business/comment/list/", params={
        "video_id": video_id,  # the post's item_id
        "status": "PUBLIC",
        "sort_field": "create_time",
        "sort_order": "desc",
        "max_count": 30,
    })
    for comment in page.get("comments", []):
        if comment.get("owner") or comment.get("replies") or comment.get("parent_comment_id"):
            continue  # the account's own comments, threads with replies, and replies
        text = write_reply(comment)
        if text:
            tt.call("POST", "business/comment/reply/create/", body={
                "video_id": video_id, "comment_id": comment["comment_id"], "text": text,  # up to 1,200 characters
            })


def reply_for(comment):
    if "price" in (comment.get("text") or "").lower():
        return f"Hi {comment.get('display_name') or 'there'}, the price list is pinned on our profile."
    return None  # leave the rest to a person


reply_to_new_comments(tt, "<ITEM_ID>", reply_for)

// Node.js
async function replyToNewComments(tt, videoId, writeReply) {
  const page = await tt.call("GET", "business/comment/list/", {
    params: { video_id: videoId, status: "PUBLIC", sort_field: "create_time", sort_order: "desc", max_count: 30 },
  });
  for (const comment of page.comments ?? []) {
    if (comment.owner || comment.replies || comment.parent_comment_id) continue; // own, already replied to, or a reply
    const text = writeReply(comment);
    if (text) {
      await tt.call("POST", "business/comment/reply/create/", {
        body: { video_id: videoId, comment_id: comment.comment_id, text }, // up to 1,200 characters
      });
    }
  }
}

function replyFor(comment) {
  if ((comment.text || "").toLowerCase().includes("price")) {
    return "Hi " + (comment.display_name || "there") + ", the price list is pinned on our profile.";
  }
  return null; // leave the rest to a person
}

replyToNewComments(tt, "<ITEM_ID>", replyFor).catch(console.error);

Πώς διαβάζετε τα insights του λογαριασμού;

GET στο /business/get/ με τα ονόματα πεδίων στο fields και ένα εύρος ημερομηνιών UTC έως 60 ημέρες. Το followers_count εμφανίζεται δύο φορές: το τρέχον σύνολο στην κορυφή του data, και το σύνολο κάθε ημέρας μέσα στο metrics, δίπλα στα video_views, profile_views, likes, comments και shares της ημέρας. Το παράδειγμα τελειώνει στη χθεσινή μέρα, επειδή οι ημερήσιες μετρήσεις φτάνουν με καθυστέρηση 24 έως 48 ωρών:

Daily account metrics for the last 7 days: Python, then Node.js
# Python
from datetime import datetime, timedelta, timezone


def daily_insights(tt, days=7):
    yesterday = datetime.now(timezone.utc).date() - timedelta(days=1)  # counts arrive 24 to 48 h late
    data = tt.call("GET", "business/get/", params={
        "fields": ["followers_count", "video_views", "profile_views", "likes", "comments", "shares"],
        "start_date": (yesterday - timedelta(days=days - 1)).isoformat(),  # UTC, up to 60 days back
        "end_date": yesterday.isoformat(),
    })
    print("Followers now:", data.get("followers_count"))
    for day in data.get("metrics", []):
        print(day["date"], day.get("followers_count"), day.get("video_views"), day.get("likes"))


daily_insights(tt)

// Node.js
async function dailyInsights(tt, days = 7) {
  const utcDay = (daysAgo) => new Date(Date.now() - daysAgo * 86400000).toISOString().slice(0, 10);
  const data = await tt.call("GET", "business/get/", {
    params: {
      fields: ["followers_count", "video_views", "profile_views", "likes", "comments", "shares"],
      start_date: utcDay(days), // UTC, up to 60 days back
      end_date: utcDay(1), // counts arrive 24 to 48 h late
    },
  });
  console.log("Followers now:", data.followers_count);
  for (const day of data.metrics ?? []) console.log(day.date, day.followers_count, day.video_views, day.likes);
}

dailyInsights(tt).catch(console.error);

Πώς επαληθεύετε την υπογραφή ενός webhook;

Υπολογίζετε ξανά ένα HMAC-SHA256 της τιμής t, μιας τελείας και του ακατέργαστου σώματος, με κλειδί το app secret, συγκρίνετε το με το s σε σταθερό χρόνο και ελέγχετε ότι το t είναι πρόσφατο. Διαβάστε το σώμα ως bytes πριν το επεξεργαστεί οτιδήποτε, απαντήστε αμέσως 200 και καταγράψτε το x-tt-logid όταν αποτυγχάνει ένας έλεγχος. Με Flask σε Python και με την ενσωματωμένη μονάδα http σε Node.js:

Receive a signed TikTok webhook: Python with Flask, then Node.js
# Python
import hashlib
import hmac
import json
import os
import time
from queue import Queue

from flask import Flask, request

app = Flask(__name__)
events = Queue()


def signature_ok(raw, header, secret, max_age=300):
    fields = {}
    for part in (header or "").split(","):
        key, sep, value = part.strip().partition("=")
        if sep:
            fields[key] = value
    t, s = fields.get("t", ""), fields.get("s", "").lower()
    if not t.isdigit() or len(s) != 64:
        return False
    expected = hmac.new(secret.encode(), t.encode() + b"." + raw, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, s) and abs(time.time() - int(t)) <= max_age


@app.post("/tiktok/webhook")
def tiktok_webhook():
    raw = request.get_data()  # the bytes TikTok signed, before any JSON parsing
    if not signature_ok(raw, request.headers.get("Tiktok-Signature"), os.environ["TIKTOK_APP_SECRET"]):
        app.logger.warning("Bad signature, x-tt-logid %s", request.headers.get("X-Tt-Logid"))
        return "", 401
    events.put(json.loads(raw))  # its content field is itself a JSON string: work on it elsewhere
    return "", 200

// Node.js
const { createServer } = require("node:http");
const { createHmac, timingSafeEqual } = require("node:crypto");

function signatureOk(raw, header, secret, maxAgeSec = 300) {
  const fields = {};
  for (const part of String(header ?? "").split(",")) {
    const i = part.indexOf("=");
    if (i > 0) fields[part.slice(0, i).trim()] = part.slice(i + 1).trim();
  }
  if (!/^\d+$/.test(fields.t ?? "") || !/^[0-9a-f]{64}$/i.test(fields.s ?? "")) return false;
  const expected = createHmac("sha256", secret).update(fields.t + ".").update(raw).digest();
  const fresh = Math.abs(Date.now() / 1000 - Number(fields.t)) <= maxAgeSec;
  return timingSafeEqual(expected, Buffer.from(fields.s, "hex")) && fresh;
}

const inbox = [];
createServer((req, res) => {
  if (req.method !== "POST" || req.url !== "/tiktok/webhook") return res.writeHead(404).end();
  const chunks = [];
  req.on("data", (chunk) => chunks.push(chunk));
  req.on("end", () => {
    const raw = Buffer.concat(chunks); // the bytes TikTok signed
    if (!signatureOk(raw, req.headers["tiktok-signature"], process.env.TIKTOK_APP_SECRET)) {
      console.warn("Bad signature, x-tt-logid", req.headers["x-tt-logid"]);
      return res.writeHead(401).end();
    }
    res.writeHead(200).end(); // answer first: TikTok retries anything but a 200 for up to 72 hours
    inbox.push(JSON.parse(raw.toString("utf8")));
  });
}).listen(3000);

Πώς εκτελείτε τις ίδιες εργασίες μέσω του easyCoexistence;

Ως κλήσεις εργαλείων από το Claude, το ChatGPT ή άλλο MCP client συνδεδεμένο στο https://easycoexistence.com/api/mcp, καθεμία παίρνει το account_id από το list_social_accounts. Το easyCoexistence στέλνει τους συνδέσμους των πολυμέσων σας στο TikTok μέσω του δικού του επαληθευμένου προθέματος URL, παρακολουθεί κάθε ανάρτηση έως ότου το TikTok την ολοκληρώσει ή την απορρίψει, και ανανεώνει το token, ενώ μια απορριφθείσα κλήση επιστρέφει τον code και το μήνυμα του TikTok:

The six jobs as MCP tool calls
// Publish a video by URL, then see where it stands
publish_tiktok_post { "account_id": "<ACCOUNT_ID>", "video_url": "https://media.example.com/tiktok/launch.mp4", "caption": "Our spring menu is live #food" }
get_tiktok_publish_status { "account_id": "<ACCOUNT_ID>", "share_id": "<SHARE_ID>" }

// Post photos
publish_tiktok_post { "account_id": "<ACCOUNT_ID>", "image_urls": ["https://media.example.com/menu/1.jpg", "https://media.example.com/menu/2.jpg"], "title": "Spring menu", "caption": "Four new dishes, from Friday #food" }

// List videos
list_social_posts { "account_id": "<ACCOUNT_ID>", "limit": 20 }

// Read comments and reply in public
list_social_comments { "account_id": "<ACCOUNT_ID>", "post_id": "<ITEM_ID>" }
reply_to_comment { "account_id": "<ACCOUNT_ID>", "post_id": "<ITEM_ID>", "comment_id": "<COMMENT_ID>", "text": "The price list is pinned on our profile." }

// Account insights
get_social_insights { "account_id": "<ACCOUNT_ID>", "metrics": ["followers_count", "video_views", "likes"], "params": { "start_date": "2026-10-26", "end_date": "2026-11-01" } }

// Comment events, signed by easyCoexistence, at your endpoint
set_social_webhook_destination { "account_id": "<ACCOUNT_ID>", "url": "https://hooks.example.com/tiktok/" }

Πώς ο δικός σας κώδικας χρησιμοποιεί λογαριασμό συνδεδεμένο στο easyCoexistence;

Λάβετε τα διαπιστευτήρια του λογαριασμού για κάθε εργασία από το Partner API και περάστε τα στον ίδιο client. GET στο /channels/{id}?credentials=1 με το κλειδί σας ec_live_ επιστρέφει το api_base, το business_id και ένα τρέχον access_token με token_expires_at, ή ένα null token με σημείωση όταν το κανάλι χρειάζεται νέα σύνδεση. Οι αναγνώσεις, οι απαντήσεις και τα insights εκτελούνται στον δικό σας κώδικα, ενώ οι αναρτήσεις περνούν από το POST /channels/{id}/posts ή το publish_tiktok_post, που δρομολογεί τα πολυμέσα μέσω του επαληθευμένου προθέματος:

A current token from the Partner API, into the same client: Python, then Node.js
# Python
def tiktok_for(channel_id):
    res = requests.get(f"https://easycoexistence.com/api/v1/channels/{channel_id}", params={"credentials": "1"},
                       headers={"Authorization": f"Bearer {os.environ['EC_API_KEY']}"}, timeout=30)
    res.raise_for_status()
    creds = res.json()["credentials"]
    if not creds.get("access_token"):
        raise RuntimeError(creds.get("note"))  # the channel needs reconnecting
    return TikTok(creds["access_token"], creds["business_id"])


print(recent_videos(tiktok_for("<CHANNEL_ID>"), 20))

// Node.js
async function tiktokFor(channelId) {
  const res = await fetch("https://easycoexistence.com/api/v1/channels/" + channelId + "?credentials=1", {
    headers: { Authorization: "Bearer " + process.env.EC_API_KEY },
  });
  if (!res.ok) throw new Error("HTTP " + res.status + " from easyCoexistence");
  const { credentials } = await res.json();
  if (!credentials.access_token) throw new Error(credentials.note); // the channel needs reconnecting
  return new TikTok(credentials.access_token, credentials.business_id);
}

tiktokFor("<CHANNEL_ID>").then((account) => recentVideos(account, 20)).then(console.log, console.error);

Συνηθισμένα λάθη

  • Ανάγνωση δεδομένων χωρίς έλεγχο του code. Μια απάντηση μπορεί να έχει HTTP 200, κωδικό 40002 και καθόλου δεδομένα, οπότε ένα πεδίο που λείπει συχνά είναι σφάλμα που ο κώδικας προσπέρασε.
  • Παράλειψη της τελικής κάθετου. Οι διαδρομές του TikTok τελειώνουν σε /, και το παράρτημα κωδικών επιστροφής αναφέρει το /tt_user/oauth2/refresh_token, χωρίς την κάθετο, ως κλήση που καταλήγει σε HTTP 404 page not found.
  • Λήψη των αναγνωριστικών απαντήσεων από το reply_list σε Node.js. Το TikTok ορίζει τα comment_id και video_id του reply_list ως αριθμούς, που το JSON.parse μπορεί να στρογγυλοποιήσει· το /business/comment/reply/list/ τα επιστρέφει ως συμβολοσειρές.
  • Αποστολή των fields ως λίστα χωρισμένη με κόμματα. Το API for Business θέλει κείμενο JSON, fields=["item_id","caption"], σε αντίθεση με το Display API στο developers.tiktok.com, που δέχεται fields=open_id,union_id.
Κάντε το με EasyCoexistence

Από US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και με τις πρώτες 3 ημέρες δωρεάν.

Συχνές ερωτήσεις

Υπάρχει επίσημο SDK του TikTok σε Python ή Node.js για το Accounts API;

Το SDK του TikTok για το API for Business διατίθεται σε Python, JavaScript και Java, αλλά η λίστα endpoints του καλύπτει διαφημίσεις, αναφορές και Business Center, χωρίς κανένα endpoint /business/ ή /tt_user/.

Γιατί μια κλήση στο TikTok επιστρέφει HTTP 200 χωρίς δεδομένα;

Το TikTok αναφέρει τα σφάλματα στο πεδίο code μιας απάντησης HTTP 200. Διαβάστε το code και το message: το 40002 είναι σφάλμα παραμέτρου, το 40001 ελλείπον δικαίωμα και το 40100 κλήση που περιορίστηκε.

Ποιες εκδόσεις Python και Node.js χρειάζονται αυτά τα παραδείγματα;

Python 3.9 ή νεότερη με requests, συν Flask για το webhook, και Node.js 18 ή νεότερη, της οποίας το ενσωματωμένο fetch και το node:crypto καλύπτουν τα υπόλοιπα.

Μπορώ να καλέσω το TikTok API από το πρόγραμμα περιήγησης;

Κρατήστε τις κλήσεις στον διακομιστή σας. Ο τύπος του token του TikTok είναι Bearer, που μπορεί να τον χρησιμοποιήσει όποιος τον κατέχει, και τα endpoints των token χρειάζονται το client_secret της εφαρμογής σας.

Συνεχίστε την ανάγνωση

Οδηγός TikTok API για το 2026: από την εφαρμογή σας έως την πρώτη ανάρτησηΗ πορεία στο TikTok API το 2026, με τη σειρά: ποιο API, έλεγχος εφαρμογής, scopes, τα tokens, δημοσίευση, κατάσταση, σχόλια, webhooks, insights και όρια.Αλλαγές στο TikTok API το 2026: τι σταμάτησε να λειτουργεί και τι να κάνετεΑλλαγές στο TikTok API το 2026, με τις νεότερες πρώτες: ισχύς tokens, is_business_account, όρια σχολίων, φόρμα πρόσβασης και sandbox, με κάθε διόρθωση.Γιατί σταματά να λειτουργεί η σύνδεση TikTok API και πώς να τη διατηρείτε ενεργήΓιατί σταματά η σύνδεση TikTok API για επιχειρήσεις: το token 24 ωρών, το refresh token, η ανάκληση πρόσβασης και πώς γίνεται νέα σύνδεση.Πώς να ανεβάσετε βίντεο στο TikTok μέσω του APIΑνεβάστε βίντεο στο TikTok με το API for Business: το publish endpoint, το JSON body, το share_id και την κλήση status, σε curl και Python.Επαλήθευση webhooks του TikTok: η κεφαλίδα υπογραφής και ο τρόπος ελέγχου τηςΕπαλήθευση webhook του TikTok API for Business: κεφαλίδα Tiktok-Signature, HMAC-SHA256 και μυστικό της εφαρμογής, σε Node.js.Όρια κλήσεων TikTok API: ανά endpoint, εφαρμογή και λογαριασμόΌρια κλήσεων του TikTok API: 40 κλήσεις το λεπτό ανά λογαριασμό και endpoint, 600 ή 1.000 ανά εφαρμογή στο Accounts API και τα τέσσερα επίπεδα.

Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.

Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.

  • 3 ημέρες δωρεάν
  • Ακύρωση ανά πάσα στιγμή
  • Μόνο επίσημα API
  • Παρακολούθηση 24/7

Επαληθεύτηκε στις