Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

TikTok API ile Python ve Node.js: çalışan örnekler

TikTok'un API for Business'ı Python veya Node.js'ten düz HTTPS istekleriyle çalışır: her çağrıyı https://business-api.tiktok.com/open_api/v1.3 adresine gönderin, hesabın token'ını Access-Token başlığında, open_id değerini ise business_id olarak iletin. TikTok çoğu çağrıya HTTP 200 ve code alanıyla yanıt verir; başarıda bu alan 0 olur, bu yüzden code'u kontrol edin ve 40100'de 5 dakika bekleyin.

easyCoexistence, Claude, ChatGPT veya kendi kodunuza aynı TikTok işlerini araç olarak sunar: publish_tiktok_post, reply_to_comment ve get_social_insights gibi.

HTTP 200

Çoğu TikTok yanıtının HTTP durumu, hatalar dahil; yalnızca gövdedeki code değeri 0 ise çağrı başarılıdır.

40100

Sınırlandırılan çağrının kodu: dakikalık limitten sonra TikTok 5 dakikalık bir ara, günlük limitten sonra ise UTC 00:00'a kadar bekleme ister.

5xx

Sunucu hataları; bu durumda TikTok, yeniden çağırmadan önce yaklaşık 5 dakika beklemeyi önerir.

Final /

Yollar eğik çizgiyle biter; TikTok'un /tt_user/oauth2/refresh_token yolunu eğik çizgisiz vermesi, 404 page not found hatasının bir nedenidir.

3 languages

Python, JavaScript ve Java, TikTok'un API for Business SDK'sında bulunur; bu SDK'nın uç nokta listesinde /business/ uç noktası yoktur.

HMAC-SHA256

Her webhook'un Tiktok-Signature başlığındaki imza; zaman damgası, bir nokta ve gövdeden hesaplanır ve uygulama gizli anahtarıyla üretilir.

Her TikTok API çağrısı neye ihtiyaç duyar?

İşe bakılmaksızın aynı beş şey gerekir:

  • Temel URL https://business-api.tiktok.com/open_api/v1.3 ve eğik çizgiyle biten bir yol, örneğin /business/video/list/.
  • Hesabın erişim token'ı, 24 saati dolmadan yenilenmiş olarak Access-Token başlığında.
  • business_id, hesabın open_id'si: GET'te sorgu dizesinde, POST'ta JSON gövdesinde.
  • GET'te liste ve nesne parametreleri, örneğin fields ve filters, JSON metni olarak gönderilir: fields=["item_id","caption"].
  • Yanıttaki code değerini kontrol edin, çünkü TikTok 40002 veya 40100 gibi hataları HTTP 200 ile gönderir ve veri yalnızca code 0 olduğunda döner.

TikTok'un hata zarfını Python'da nasıl işlersiniz?

business_id'yi her metodun beklediği yere koyan küçük bir istemciyle: code 0 olduğunda veriyi döndürür, aksi halde TikTokError fırlatır. Sınırlandırılmış çağrıyı TikTok'un 5 dakikalık molasından sonra yeniden dener, çünkü 40100, TikTok'un çağrıyı reddettiği anlamına gelir. 5xx hatasını yalnızca GET'te yeniden dener, çünkü sunucu hatasıyla sonuçlanan bir yayın yine de TikTok'a ulaşmış olabilir. requests gerekir; sonraki Python örnekleri onu yeniden kullanır:

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'te nasıl işlersiniz?

Aynı istemci, Node.js 18 ve sonraki sürümlerle gelen yerleşik fetch üzerinde çalışır, kurulacak bir şey yoktur. GET için liste parametrelerini JSON olarak kodlar, POST için business_id'yi gövdeye koyar ve hatada TikTok'un code değerini korur. Böylece çağıranlar, bir token sorunu olan 40102 ve 40105'i, eksik izni gösteren 40001'den ayırt edebilir:

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);

Bir videoyu URL ile nasıl yayınlar ve durumunu nasıl kontrol edersiniz?

video_url ve post_info ile POST /business/video/publish/ çağırın, ardından share_id değerini publish_id olarak kullanarak /business/publish/status/ uç noktasını sorgulayın. Döngü, TikTok'un nedeniyle birlikte FAILED durumunda durur; PUBLISH_COMPLETE durumunda ise post_ids gelene kadar bekler, TikTok bunun üç dakikaya kadar sürebileceğini söyler. video_url, uygulamanız için doğrulanmış bir alan adında veya URL öneki içinde bulunmalıdır:

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);

Fotoğraf nasıl paylaşılır?

Önce hesabın izin verilen ayarlarını okuyun, sonra POST /business/photo/publish/ çağırın. Fotoğraf gönderisi privacy_level ister; bu değer /business/video/settings/ uç noktasındaki privacy_level_options değerlerinden biri olmalıdır. Oradaki comment_disabled true ise disable_comment de true olmalıdır. Dönen share_id, bir videoyla aynı bekleme işleviyle izlenir:

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);

Bir hesabın videolarını nasıl listelersiniz?

İstediğiniz alanlarla GET /business/video/list/ çağırın; item_id de bunlar arasında olsun. Sayfa başına en yeni gönderiden başlayarak en fazla 20 gönderi gelir. has_more true olduğu sürece, dönen cursor değerini (milisaniye cinsinden bir UTC zaman damgası) iletin ve kısa sayfalar gelebileceğini göz önünde bulundurun. TikTok'un güven ve güvenlik kuralları, liste bitmeden önce max_count'tan az sonuç döndürebilir.

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);

Yorumları nasıl okuyup yanıtlarsınız?

Gönderinin item_id değerini video_id olarak kullanarak GET /business/comment/list/ çağırın; sayfa başına en fazla 30 yorum döner. POST /business/comment/reply/create/ ise bir yoruma en fazla 1.200 karakterlik metinle herkese açık yanıt verir. Örnek, henüz yanıtı olmayan, üst düzey ve herkese açık yorumları yanıtlar, hesabın kendi yorumlarını atlar ve yazımı, sizin yazacağınız bir işleve bırakır; çünkü TikTok, yakın zamanda gönderilen büyük ölçüde benzer yorumları spam olarak gizleyebilir:

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);

Hesap içgörülerini nasıl okursunuz?

fields içindeki alan adlarıyla ve en fazla 60 günlük bir UTC tarih aralığıyla GET /business/get/ çağırın. followers_count iki kez gelir: data'nın en üstünde güncel toplam, metrics içinde ise her gün için o günkü video_views, profile_views, likes, comments ve shares değerleriyle birlikte o günkü toplam. Örnek dünle biter, çünkü günlük sayılar 24 ila 48 saat geç gelir:

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);

Bir webhook imzasını nasıl doğrularsınız?

t değerinin, bir noktanın ve ham gövdenin HMAC-SHA256'sını uygulama gizli anahtarıyla yeniden hesaplayın, s ile sabit zamanlı karşılaştırma yapın ve t'nin güncel olup olmadığını kontrol edin. Gövdeyi herhangi bir ayrıştırmadan önce bayt olarak okuyun, hemen 200 ile yanıt verin ve kontrol başarısız olduğunda x-tt-logid değerini kaydedin. Python için Flask, Node.js için yerleşik http modülü kullanılır:

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);

Aynı işleri easyCoexistence üzerinden nasıl çalıştırırsınız?

Claude, ChatGPT veya başka bir MCP istemcisinden https://easycoexistence.com/api/mcp adresine bağlanarak araç çağrıları olarak; her biri account_id değerini list_social_accounts'tan alır. easyCoexistence, medya adreslerinizi kendi doğrulanmış URL öneki üzerinden TikTok'a gönderir, her gönderiyi TikTok tamamlayana veya başarısız kılana kadar izler ve token'ı yeniler. Reddedilen bir çağrı ise TikTok'un code ve message değerleriyle döner:

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/" }

Kendi kodunuz, easyCoexistence'a bağlı bir hesabı nasıl kullanır?

Her iş için hesabın kimlik bilgilerini Partner API'den alın ve aynı istemciye verin. ec_live_ anahtarınızla GET /channels/{id}?credentials=1 çağrıldığında api_base, business_id ve güncel bir access_token ile token_expires_at döner. Kanalın yeniden bağlanması gerekiyorsa bunun yerine bir notla birlikte null token gelir. Okumalar, yanıtlar ve içgörüler bundan sonra kendi kodunuzdan çalışır; gönderiler ise medyayı doğrulanmış önek üzerinden yönlendiren POST /channels/{id}/posts veya publish_tiktok_post üzerinden gider:

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);

Yaygın hatalar

  • code değerine bakmadan veri okumak. Bir yanıt HTTP 200, code 40002 ve hiç veri taşıyabilir; bu nedenle eksik bir alan, çoğu zaman kodun atladığı bir hatadır.
  • Sondaki eğik çizgiyi atmak. TikTok'un yolları / ile biter; dönüş kodu ekinde /tt_user/oauth2/refresh_token, eğik çizgisiz olarak, HTTP 404 page not found ile biten bir çağrı olarak geçer.
  • Node.js'te reply_list'ten yanıt kimliklerini almak. TikTok'un referansı, reply_list'in comment_id ve video_id alanlarını sayı olarak tanımlar; JSON.parse bunları yuvarlayabilir. /business/comment/reply/list/ ise bunları metin olarak döndürür.
  • fields alanını virgülle ayrılmış liste olarak göndermek. Business için API JSON metni ister: fields=["item_id","caption"]. Oysa developers.tiktok.com'daki Display API, fields=open_id,union_id biçimini alır.
Bunu EasyCoexistence'la yapmak

Scriptlerinize ise get_social_credentials veya Partner API ile güncel bir token verir. Bağlantı başına ayda US$ 9'dan US$ 0.75'e kadar, bağlantı ekledikçe düşen fiyatla; ilk 3 gün ücretsiz deneme ile.

Sık sorulan sorular

TikTok'un Accounts API için resmi bir Python veya Node.js SDK'sı var mı?

TikTok'un API for Business SDK'sı Python, JavaScript ve Java olarak gelir; ancak uç nokta listesi reklamları, raporlamayı ve Business Center'ı kapsar, /business/ veya /tt_user/ uç noktası yoktur.

Neden bir TikTok çağrısı veri olmadan HTTP 200 döndürür?

TikTok, hataları HTTP 200 yanıtının code alanında bildirir. code ve message değerlerini okuyun: 40002 parametre hatası, 40001 eksik izin ve 40100 sınırlandırılmış çağrıdır.

Bu örnekler hangi Python ve Node.js sürümlerini gerektirir?

requests ile birlikte Python 3.9 veya sonrası, webhook için Flask ile birlikte; ayrıca Node.js 18 veya sonrası, yerleşik fetch ve node:crypto geri kalanını karşılar.

TikTok API'sini tarayıcıdan çağırabilir miyim?

Çağrıları sunucunuzda tutun. TikTok'un token türü Bearer'dır; onu elinde bulunduran herkes kullanabilir, token uç noktaları ise uygulamanızın client_secret değerini ister.

Okumaya devam edin

İlk kanalınızı iki dakikada bağlayın.

Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.

  • 3 gün ücretsiz
  • İstediğiniz zaman iptal
  • Yalnızca resmi API'ler
  • 7/24 izleniyor

Doğrulama tarihi