TikTok API برائے کاروبار کے ایکسیس ٹوکن: 24 گھنٹے، ریفریش اور منسوخی
TikTok API برائے کاروبار کا ایکسیس ٹوکن 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 آپ کے اسکرپٹس کو دیتا ہے۔
TikTok اکاؤنٹ کے ایکسیس ٹوکن کی مدت؛ ہر ٹوکن جواب میں expires_in میں باقی سیکنڈ بتاتا ہے۔
اس کے ساتھ جاری ہونے والے ریفریش ٹوکن کی مدت؛ refresh_token_expires_in اس کے باقی سیکنڈ دیتا ہے۔
ری ڈائریکٹ میں ملنے والے اجازت کے کوڈ کی مدت؛ اسے صرف ایک بار تبادلہ کیا جا سکتا ہے۔
اکاؤنٹ کی ایپ مخصوص ID، جو ہر ٹوکن کے ساتھ آتی ہے اور اکاؤنٹس API کالز میں business_id کے طور پر بھیجی جاتی ہے۔
TikTok کا واپس کیا گیا token_type؛ جو شخص ٹوکن رکھتا ہے وہ اکاؤنٹ کے وسائل تک رسائی حاصل کر سکتا ہے۔
/tt_user/token_info/get/ جو اکاؤنٹ ID اسکوپ کے ساتھ دیتا ہے، جو اکاؤنٹس API کالز میں business_id کے طور پر استعمال ہو سکتی ہے۔
اجازت کا کوڈ آپ کی ایپ تک کیسے پہنچتا ہے؟
TikTok اکاؤنٹ مالک کا اجازت URL کے ذریعے، جسے TikTok ڈویلپر ایپ کے لیے میری ایپس، ایپ کی تفصیل، بنیادی معلومات میں بناتا ہے، جب ایپ کے پاس TikTok اکاؤنٹس کی اجازت ہو۔ اکاؤنٹ کا مالک اسے کھولتا ہے، اجازتوں کا جائزہ لیتا ہے اور انہیں منظور کرتا ہے۔ اس کے بعد TikTok براؤزر کو ایپ کے ری ڈائریکٹ URL پر بھیجتا ہے، جس کے ساتھ auth_code اور اجازت URL میں موجود کوئی بھی state ویلیو شامل ہوتی ہے۔ یہ کوڈ 10 منٹ تک اور صرف ایک تبادلے کے لیے کارآمد ہے۔
- ری ڈائریکٹ URL: مطلق ہو، https:// سے شروع ہو، / پر ختم ہو، اس میں کوئی کیوری اسٹرنگ، اینکر یا پورٹ نہ ہو، اور اس کی لمبائی 10 سے 512 حروف ہو۔
- ہر ایپ کے لیے 10 تک ری ڈائریکٹ URLs، جن میں سے ایک بیک وقت فعال ہو؛ کسی ایک کو فعال کرنے سے اس کا اپنا اجازت URL بنتا ہے۔
- state: ایک اختیاری ویلیو جو TikTok ری ڈائریکٹ پر واپس بھیجتا ہے، اور جسے TikTok CSRF کے خلاف حفاظت کے طور پر تجویز کرتا ہے۔
disable_auto_auth=1: ان اکاؤنٹ مالکان کو جائزے کا صفحہ دکھاتا ہے جنہوں نے پہلے یہی اجازتیں منظور کی تھیں، جنہیں TikTok ورنہ فوراً ری ڈائریکٹ کر دیتا ہے۔
کوڈ کا ٹوکن کے لیے تبادلہ کیسے کریں؟
آپ کے سرور سے /tt_user/oauth2/token/ پر JSON کے ساتھ POST کے ذریعے۔ client_id اور client_secret وہ ایپ ID اور Secret ہیں جو میری ایپس، ایپ کی تفصیل، بنیادی معلومات میں دکھائے جاتے ہیں؛ grant_type کی ویلیو authorization_code ہے؛ auth_code ری ڈائریکٹ سے ملا کوڈ ہے؛ اور redirect_uri کو ایپ میں سیٹ کیے گئے TikTok اکاؤنٹ مالک کے ری ڈائریکٹ URL کے برابر ہونا ضروری ہے۔
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 اکاؤنٹ کی ایپ مخصوص ID۔
{
"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/ تک کے اکاؤنٹس 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/ پر client_id، client_secret، grant_type کی ویلیو refresh_token اور محفوظ کیے گئے refresh_token کے ساتھ POST کے ذریعے۔ جواب میں وہی فیلڈز ہوتے ہیں جو پہلے تبادلے میں تھے: نیا access_token اور اس کا expires_in، ایک refresh_token جو اگلی تجدید کے لیے رکھنا ہے، اور اس کے باقی سیکنڈ۔ تجدید 24 گھنٹے ختم ہونے سے پہلے شیڈول کریں، خرابی 40102 کا انتظار کرنے کے بجائے۔
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 ہو؛ کامیابی پر code 0 اور خالی data آبجیکٹ واپس آتا ہے۔ اکاؤنٹ کی طرف سے، مالک TikTok ایپ کھولتا ہے، سیٹنگز اور رازداری، سیکیورٹی، ایپ کی اجازتیں منظم کریں پر جاتا ہے، ایپ منتخب کرتا ہے اور رسائی ہٹائیں چنتا ہے۔ اجازت منسوخ ہونے کے بعد TikTok اس اکاؤنٹ کے لیے ایپ کو comment.update ایونٹس بھیجنا بند کر دیتا ہے۔
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 اکاؤنٹ کی ایپ مخصوص ID ہے، وہی ویلیو جو اکاؤنٹس API کالز business_id کے طور پر لیتی ہیں۔ TikTok کے حوالہ جات ڈویلپرز کو یہاں اس وقت بھیجتے ہیں جب کسی فیلڈ کو ایسے اسکوپ کی ضرورت ہو جو ٹوکن کے پاس نہ ہو سکتا ہو۔
ٹوکن سے کون سی خرابیاں آتی ہیں؟
TikTok انہیں جواب کے code فیلڈ میں ڈالتا ہے، عموماً HTTP اسٹیٹس 200 کے تحت، اس لیے کال پر بھروسہ کرنے سے پہلے code چیک کریں۔ ٹوکن اور ان کے تبادلے سے جڑے ریٹرن کوڈز یہ ہیں:
- 40102: ایکسیس ٹوکن ختم ہو چکا ہے؛ اسے تجدید کریں اور دوبارہ کال کریں۔
- 40103: ریفریش ٹوکن ختم ہو چکا ہے؛ اس کی جگہ صرف مالک کی نئی اجازت ہی لے سکتی ہے۔
- 40104: درخواست میں کوئی ایکسیس ٹوکن نہیں تھا۔
- 40105: ایکسیس ٹوکن غلط یا ناقص ہے۔
- 40107: ریفریش ٹوکن غلط ہے، مثلاً وہ جو Marketing API ٹوکن کی تجدید کے لیے بھیجا گیا، جس کی مدت کبھی ختم نہیں ہوتی۔
- 40110: اجازت کا کوڈ منسوخ ہو گیا، پہلے استعمال ہو چکا ہے، یا ختم ہو چکا ہے۔
- 40131: دونوں ٹوکن اینڈ پوائنٹس پر توثیق کی خرابی، جو غلط ایپ ID یا سیکرٹ، ختم شدہ کوڈ، یا غلط یا ختم شدہ ریفریش ٹوکن سے آتی ہے۔
easyCoexistence آپ کے لیے کیا تجدید کرتا ہے؟
سائن ان کے بعد کا سب کچھ۔ easyCoexistence TikTok کے ری ڈائریکٹ واپس آتے ہی کوڈ کا تبادلہ کرتا ہے، دونوں ٹوکن انکرپٹڈ کر کے محفوظ کرتا ہے، اور ایکسیس ٹوکن خود تجدید کرتا ہے: کال سے پہلے جب 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 شامل کریں۔
US$ 9 سے US$ 0.75 فی کنکشن فی مہینہ، کنکشن بڑھنے کے ساتھ کم ہوتی جاتی ہے، پہلے 3 دن فری۔
اکثر پوچھے جانے والے سوالات
TikTok API برائے کاروبار کا ایکسیس ٹوکن کتنی دیر چلتا ہے؟
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 سے، جسے اکاؤنٹس API کالز business_id کے طور پر لیتی ہیں۔ /tt_user/token_info/get/ وہی ID creator_id کے طور پر واپس کرتا ہے۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ