লগ ইনফ্রি ট্রায়াল শুরু করুন
easyCoexistence অফিসিয়াল API

TikTok API for Business-এর অ্যাক্সেস টোকেন: 24 ঘণ্টা, রিফ্রেশ ও প্রত্যাহার

TikTok API for Business-এর একটি অ্যাক্সেস টোকেনের মেয়াদ 24 ঘণ্টা, এবং এটি Access-Token হেডারে পাঠানো হয়। একটি অ্যাপ অ্যাকাউন্টের মালিকের অনুমোদন কোড বিনিময় করে এটি পায়, /tt_user/oauth2/token/ এন্ডপয়েন্টে। এর সঙ্গে আসে একটি রিফ্রেশ টোকেন, যার মেয়াদ এক বছর এবং যা /tt_user/oauth2/refresh_token/ এন্ডপয়েন্টে অ্যাক্সেস নবায়ন করে। প্রত্যাহার করতে /tt_user/oauth2/revoke/ ব্যবহার করুন, আর মঞ্জুর করা স্কোপ দেখতে /tt_user/token_info/get/ ব্যবহার করুন।

easyCoexistence একটি TikTok অ্যাকাউন্ট সাইন ইন করলে কোড বিনিময় করে, 24 ঘণ্টার টোকেন শেষ হওয়ার আগে নবায়ন করে এবং প্রতি প্রায় 6 ঘণ্টায় অ্যাকাউন্ট পরীক্ষা করে, যাতে Claude, ChatGPT বা আপনার নিজের কোড একটি বর্তমান টোকেন দিয়ে TikTok-এ কল করে, যা get_social_credentials আপনার স্ক্রিপ্টগুলোকে দেয়।

24 hours

একটি TikTok অ্যাকাউন্ট অ্যাক্সেস টোকেনের মেয়াদ; প্রতিটি টোকেন প্রতিক্রিয়ায় expires_in-এ বাকি সেকেন্ড বলা থাকে।

1 year

এর সঙ্গে ইস্যু হওয়া রিফ্রেশ টোকেনের বৈধতা; refresh_token_expires_in-এ এর বাকি সেকেন্ড দেওয়া থাকে।

10 minutes

রিডাইরেক্টে আসা অনুমোদন কোডটি কতক্ষণ বৈধ থাকে; এটি শুধু একবারই বিনিময় করা যায়।

open_id

অ্যাকাউন্টের অ্যাপ-নির্দিষ্ট আইডি, যা প্রতিটি টোকেনের সঙ্গে ফেরত আসে এবং Accounts API কলে business_id হিসেবে পাঠাতে হয়।

Bearer

TikTok যে token_type ফেরত দেয়: টোকেন যার হাতে আছে, সে এটি দিয়ে অ্যাকাউন্টের রিসোর্সে পৌঁছাতে পারে।

creator_id

/tt_user/token_info/get/ যে অ্যাকাউন্ট ID ফেরত দেয়, যা স্কোপের পাশে থাকে এবং Accounts API কলে business_id হিসেবে ব্যবহারযোগ্য।

অনুমোদন কোড অ্যাপে কীভাবে পৌঁছায়?

TikTok অ্যাকাউন্টের মালিকের অনুমোদন URL-এর মাধ্যমে, যা TikTok একটি ডেভেলপার অ্যাপের জন্য My Apps, App Detail, Basic Information-এর অধীনে তৈরি করে, যখন অ্যাপের TikTok Accounts পারমিশন থাকে। অ্যাকাউন্টের মালিক এটি খোলেন, পারমিশনগুলো দেখেন এবং অনুমোদন দেন। এরপর TikTok ব্রাউজারকে অ্যাপের রিডাইরেক্ট URL-এ পাঠায়, সঙ্গে যোগ করে auth_code এবং অনুমোদন URL-এ থাকা যেকোনো state মান। কোডটি 10 মিনিট বৈধ থাকে এবং একবারই বিনিময় করা যায়।

  • রিডাইরেক্ট URL: পরম, https:// দিয়ে শুরু, / দিয়ে শেষ, কোনো query string, anchor বা port ছাড়া, এবং দৈর্ঘ্যে 10 থেকে 512 অক্ষর।
  • প্রতি অ্যাপে সর্বোচ্চ 10টি রিডাইরেক্ট URL, একবারে একটি সক্রিয়; একটি সক্রিয় করলে তার নিজস্ব অনুমোদন URL তৈরি হয়।
  • state: একটি ঐচ্ছিক মান যা TikTok রিডাইরেক্টে ফেরত পাঠায়; CSRF প্রতিরোধে সুরক্ষা হিসেবে TikTok এটি ব্যবহারের পরামর্শ দেয়।
  • disable_auto_auth=1: যেসব মালিক আগে একই পারমিশন অনুমোদন দিয়েছেন তাদের জন্য রিভিউ পেজ দেখায়, নইলে TikTok তাদের সরাসরি রিডাইরেক্ট করে।

আপনি কোডের বিনিময়ে টোকেন কীভাবে পাবেন?

আপনার সার্ভার থেকে JSON হিসেবে /tt_user/oauth2/token/-এ একটি POST পাঠিয়ে। client_id ও client_secret হলো My Apps, App Detail, Basic Information-এর অধীনে দেখানো App ID ও Secret; grant_type হলো authorization_code; auth_code হলো রিডাইরেক্টের কোড; আর redirect_uri অবশ্যই অ্যাপে সেট করা TikTok অ্যাকাউন্টের মালিকের রিডাইরেক্ট URL-এর সমান হতে হবে।

Exchange the authorization code
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/oauth2/token/' \
  -H 'Content-Type: application/json' \
  -d '{
    "client_id": "<APP_ID>",
    "client_secret": "<APP_SECRET>",
    "grant_type": "authorization_code",
    "auth_code": "<AUTH_CODE>",
    "redirect_uri": "https://app.example.com/tiktok/callback/"
  }'

টোকেনের প্রতিক্রিয়ায় কী থাকে?

একটি JSON অবজেক্ট, যাতে থাকে code, message, request_id ও data। code 0 মানে বিনিময় সফল হয়েছে, আর data-তে থাকে দুটি টোকেন এবং অ্যাকাউন্টের ID:

  • access_token: API কলের জন্য স্বল্পমেয়াদি টোকেন, যা এক দিন বৈধ।
  • token_type: Bearer, যা TikTok বর্ণনা করে এমন হিসেবে যে টোকেন যার হাতে থাকে সে ব্যবহার করতে পারে।
  • scope: টোকেনকে দেওয়া পারমিশনগুলো, একটি কমা-বিচ্ছিন্ন স্ট্রিং হিসেবে।
  • expires_in: অ্যাক্সেস টোকেনের মেয়াদ শেষ হওয়ার আগে বাকি সেকেন্ড, TikTok-এর উদাহরণে 86400।
  • refresh_token: যে টোকেন অ্যাক্সেস নবায়ন করে, এক বছরের জন্য বৈধ; TikTok এটি সংরক্ষণ করে রাখার পরামর্শ দেয়।
  • refresh_token_expires_in: রিফ্রেশ টোকেনের মেয়াদ শেষ হওয়ার আগে বাকি সেকেন্ড।
  • open_id: TikTok অ্যাকাউন্টের অ্যাপ-নির্দিষ্ট আইডি।
A token response (scope shortened)
{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "access_token": "<ACCESS_TOKEN>",
    "token_type": "Bearer",
    "scope": "user.info.basic,user.info.stats,user.insights,video.list,video.insights,video.publish,comment.list,comment.list.manage",
    "expires_in": 86400,
    "refresh_token": "<REFRESH_TOKEN>",
    "refresh_token_expires_in": 31536000,
    "open_id": "<OPEN_ID>"
  }
}

API কলে টোকেন কীভাবে পাঠানো হয়?

Access-Token নামের একটি রিকোয়েস্ট হেডারে, /business/get/ থেকে /business/video/publish/ পর্যন্ত Accounts API এন্ডপয়েন্টে; আর অ্যাকাউন্টটি business_id-তে উল্লেখ করা হয়, একই প্রতিক্রিয়ার open_id-তে সেট করে। OAuth এন্ডপয়েন্টগুলো উল্টো পথে কাজ করে: /tt_user/oauth2/token/, /tt_user/oauth2/refresh_token/ ও /tt_user/oauth2/revoke/ অ্যাপের client_id ও client_secret JSON বডিতে নেয় এবং কোনো Access-Token হেডার নেয় না।

অ্যাক্সেস টোকেন কীভাবে নবায়ন করবেন?

/tt_user/oauth2/refresh_token/-এ একটি POST পাঠিয়ে, যাতে থাকে client_id, client_secret, grant_type যার মান refresh_token, এবং সংরক্ষিত refresh_token। উত্তরে প্রথম বিনিময়ের মতো একই ফিল্ড থাকে: নতুন access_token ও তার expires_in, পরের নবায়নের জন্য রাখার মতো একটি refresh_token ও সেটির বাকি সেকেন্ড। ত্রুটি 40102 আসার অপেক্ষা না করে 24 ঘণ্টা শেষ হওয়ার আগেই নবায়নের সময়সূচি ঠিক করুন।

Renew a TikTok account access token in Python
import os, time, requests

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

def renew(refresh_token: str) -> dict:
    r = requests.post(f"{API}/tt_user/oauth2/refresh_token/", json={
        "client_id": os.environ["TIKTOK_APP_ID"],
        "client_secret": os.environ["TIKTOK_APP_SECRET"],
        "grant_type": "refresh_token",
        "refresh_token": refresh_token,
    }, timeout=30).json()
    if r["code"] != 0:  # 40103: the refresh token expired, so the owner authorizes again
        raise RuntimeError(f"{r['code']}: {r['message']}")
    d, now = r["data"], time.time()
    return {
        "access_token": d["access_token"],
        "access_expires_at": now + d["expires_in"],
        "refresh_token": d["refresh_token"],  # keep it for the next renewal
        "refresh_expires_at": now + d["refresh_token_expires_in"],
    }

অ্যাক্সেস কীভাবে প্রত্যাহার করবেন?

অ্যাপ থেকে, /tt_user/oauth2/revoke/-এ একটি POST পাঠিয়ে, যাতে থাকে client_id, client_secret এবং প্রত্যাহার করার access_token; সফল হলে ফাঁকা data অবজেক্টসহ code 0 ফেরত আসে। অ্যাকাউন্ট থেকে, মালিক TikTok অ্যাপ খুলে Settings and privacy, Security, Manage app permissions-এ যান, অ্যাপটি বেছে নেন এবং Remove access বেছে নেন। অনুমোদন প্রত্যাহার হলে TikTok ওই অ্যাকাউন্টের জন্য অ্যাপে আর comment.update ইভেন্ট পাঠায় না।

Revoke a TikTok account access token
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/oauth2/revoke/' \
  -H 'Content-Type: application/json' \
  -d '{"client_id": "<APP_ID>", "client_secret": "<APP_SECRET>", "access_token": "<ACCESS_TOKEN>"}'

# {"code": 0, "message": "OK", "request_id": "<REQUEST_ID>", "data": {}}

টোকেন কীভাবে পরীক্ষা করবেন?

/tt_user/token_info/get/-এ একটি POST পাঠিয়ে, যার নিজস্ব কোনো পারমিশন লাগে না: app_id ও access_token পাঠান, আর data ফেরত দেয় app_id, scope ও creator_id। scope দেখায় মালিক কী মঞ্জুর করেছেন, আর creator_id হলো অ্যাকাউন্টের অ্যাপ-নির্দিষ্ট আইডি, যা Accounts API কলে business_id হিসেবে নেওয়া হয়। TikTok-এর রেফারেন্সগুলো যখনই কোনো ফিল্ডের জন্য এমন স্কোপ লাগে যা টোকেনের নাও থাকতে পারে, তখন ডেভেলপারদের এখানে পাঠায়।

টোকেন থেকে কোন ত্রুটি আসে?

TikTok এগুলো প্রতিক্রিয়ার code ফিল্ডে রাখে, সাধারণত HTTP স্ট্যাটাস 200-এর অধীনে, তাই কোনো কল বিশ্বাস করার আগে code দেখুন। টোকেন ও তার বিনিময়ের সঙ্গে জড়িত রিটার্ন কোডগুলো:

  • 40102: অ্যাক্সেস টোকেনের মেয়াদ শেষ; নবায়ন করে আবার কল করুন।
  • 40103: রিফ্রেশ টোকেনের মেয়াদ শেষ; শুধু মালিকের নতুন অনুমোদনই এটি প্রতিস্থাপন করতে পারে।
  • 40104: রিকোয়েস্টে কোনো অ্যাক্সেস টোকেন ছিল না।
  • 40105: অ্যাক্সেস টোকেন অবৈধ বা ভুল।
  • 40107: রিফ্রেশ টোকেন অবৈধ বা ভুল, যেমন কোনো Marketing API টোকেন নবায়ন করতে পাঠানো হলে, যার কোনো মেয়াদ শেষ হয় না।
  • 40110: অনুমোদন কোড বাতিল হয়েছে, আগেই ব্যবহার হয়েছে বা মেয়াদ শেষ হয়েছে।
  • 40131: দুটি টোকেন এন্ডপয়েন্টে প্রমাণীকরণ ত্রুটি; ভুল অ্যাপ ID বা secret, মেয়াদ শেষ কোড, বা অবৈধ বা মেয়াদোত্তীর্ণ রিফ্রেশ টোকেন থেকে।

easyCoexistence আপনার জন্য কী নবায়ন করে?

সাইন-ইনের পর সবকিছু। TikTok রিডাইরেক্ট করা মাত্র easyCoexistence কোড বিনিময় করে, দুটি টোকেনই এনক্রিপ্ট করে সংরক্ষণ করে এবং অ্যাক্সেস টোকেন নিজেই নবায়ন করে: কোনো কলের আগে যখন 15 মিনিটের কম বাকি থাকে, আর প্রতি প্রায় 6 ঘণ্টায় প্রতিটি অ্যাকাউন্টে চালানো পরীক্ষার সময়, যখন 8 ঘণ্টার কম বাকি থাকে। প্রতিটি নবায়ন নতুন রিফ্রেশ টোকেন ও তার মেয়াদ সংরক্ষণ করে, এবং একসঙ্গে আসা কলগুলো একটি নবায়ন ভাগ করে নেয়।

  • প্রত্যাখ্যাত টোকেন: TikTok যখন 40102, 40104 বা 40105 ফেরত দেয়, তখন সংযোগটি পুনরায় সংযোগের জন্য চিহ্নিত হয় এবং মালিক একটি ইমেইল পান; Partner API ব্যবহারকারীরা channel.disconnected-ও পান।
  • আপনার নিজের কোড: get_social_credentials, বা Partner API-তে GET /channels/{id}?credentials=1, বর্তমান টোকেন token_expires_at-সহ ফেরত দেয়, তাই প্রতিটি জবের জন্য এটি আনুন।
  • অপসারণ: ড্যাশবোর্ডে সংযোগ সরালে, বা DELETE /channels/{id} দিয়ে, /tt_user/oauth2/revoke/-এর মাধ্যমে TikTok-এ টোকেন প্রত্যাহার হয়।

সাধারণ ভুলগুলো

  • ব্রাউজারে অনুমোদন কোড বিনিময় করা। বিনিময়ে অ্যাপের client_secret পাঠানো হয়, তাই এটি আপনার সার্ভার থেকে, রিডাইরেক্টের 10 মিনিটের মধ্যে করুন।
  • expires_in-কে তারিখ ধরা। এতে বাকি সেকেন্ড থাকে, তাই কখন টোকেনের মেয়াদ শেষ হবে জানতে এটি প্রতিক্রিয়ার সময়ের সঙ্গে যোগ করুন।
  • রিফ্রেশ টোকেন দিয়ে প্রত্যাহার করা। /tt_user/oauth2/revoke/ নেয় access_token, সঙ্গে অ্যাপের client_id ও client_secret।
  • অনুপস্থিত সম্মতি স্ক্রিনকে ব্যর্থতা ধরা। যেসব পারমিশন মালিক আগে অনুমোদন দিয়েছেন, TikTok সেগুলোর রিভিউ পেজ বাদ দেয়; এটি আবার দেখাতে disable_auto_auth=1 যোগ করুন।
EasyCoexistence দিয়ে এটি করা

সংযোগ প্রতি মাসে US$ 9 থেকে US$ 0.75, সংযোগ বাড়ার সঙ্গে কমে, প্রথম 3 দিন ফ্রি ট্রায়াল।

প্রায়শই জিজ্ঞাসিত প্রশ্ন

একটি TikTok API for Business অ্যাক্সেস টোকেন কতক্ষণ থাকে?

24 ঘণ্টা। প্রতিটি টোকেন প্রতিক্রিয়ায় expires_in-এ বাকি সেকেন্ড দেয়, আর এক বছর বৈধ রিফ্রেশ টোকেন এটি নবায়ন করে।

TikTok-এর রিফ্রেশ এন্ডপয়েন্টে কি redirect_uri লাগে?

এর প্যারামিটার টেবিলে client_id, client_secret, grant_type ও refresh_token আছে, redirect_uri নেই; যদিও TikTok-এর প্রমাণীকরণ গাইড বলে এর টোকেন এন্ডপয়েন্টগুলোতে redirect_uri লাগে।

TikTok টোকেন প্রত্যাহার করলে কি এর ওয়েবহুক বন্ধ হয়?

হ্যাঁ। মালিক অ্যাপকে আবার অনুমোদন না দেওয়া পর্যন্ত TikTok ওই অ্যাকাউন্টের জন্য অ্যাপে আর comment.update ইভেন্ট পাঠায় না।

TikTok business_id কোথা থেকে আসে?

টোকেন প্রতিক্রিয়ার open_id থেকে, যা Accounts API কলে business_id হিসেবে নেওয়া হয়। /tt_user/token_info/get/ একই ID creator_id হিসেবে ফেরত দেয়।

আরও পড়ুন

TikTok API for Business-এর স্কোপ: প্রতিটি অনুমতি কী খুলে দেয়TikTok Accounts API-এর অনুমতি, TikTok-এর নিজের নামে: প্রতিটি কী খুলে দেয়, প্রতি ফিল্ডের টোকেন স্কোপ এবং টোকেন যাচাইয়ের উপায়।TikTok ত্রুটি 40102: অ্যাকসেস টোকেনের মেয়াদ শেষTikTok ত্রুটি 40102 মানে অ্যাকসেস টোকেনের মেয়াদ শেষ। Accounts API টোকেন এক দিন চলে; রিফ্রেশ টোকেন দিয়ে নবায়ন ও পুনঃসংযোগের সময় জানুন।TikTok ত্রুটি 40103: রিফ্রেশ টোকেনের মেয়াদ শেষTikTok ত্রুটি 40103: রিফ্রেশ টোকেনের মেয়াদ শেষ, তাই অ্যাক্সেস নবায়ন করা যায় না। Accounts API রিফ্রেশ টোকেন এক বছর চলে; সমাধান হলো নতুন অনুমোদন।TikTok API for Business বনাম Content Posting APIকেন TikTok-এর API for Business, developers.tiktok.com নয়: কমেন্ট ও তাদের ওয়েবহুক, ইনসাইটস, কোন অ্যাকাউন্ট যুক্ত হয় এবং টোকেন কীভাবে নবায়ন হয়।TikTok API for Business-এর ওয়েবহুক সেটআপ করাTikTok API for Business অ্যাপকে ওয়েবহুকে সাবস্ক্রাইব করার উপায়: /business/webhook/update/, VIDEO ও COMMENT ইভেন্ট, কলব্যাক নিয়ম এবং Tiktok-Signature।কীভাবে API-এর মাধ্যমে TikTok-এ ভিডিও পোস্ট করবেনAPI for Business দিয়ে TikTok-এ ভিডিও পোস্ট করুন: প্রকাশ এন্ডপয়েন্ট, JSON বডি, share_id এবং স্ট্যাটাস কল, curl ও Python-এ।

দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।

প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।

  • 3 দিন ফ্রি
  • যেকোনো সময় বাতিল করুন
  • শুধুমাত্র অফিশিয়াল API
  • 24/7 পর্যবেক্ষণ

যাচাই করা হয়েছে