TikTok API for Business کے اسکوپس: ہر اجازت کیا کھولتی ہے
TikTok کا API for Business رسائی کو دو تہوں میں دیتا ہے۔ ڈویلپر ایپ کے پاس TikTok Accounts کے تحت اجازتیں ہوتی ہیں، جیسے Video Publish اور Manage Account Comment، جو اینڈ پوائنٹس کھولتی ہیں۔ اکاؤنٹ اونر کی منظوری ایکسیس ٹوکن کو اسکوپس دیتی ہے، جیسے user.insights اور video.list، جو واپس آنے والی فیلڈز طے کرتے ہیں۔ /tt_user/token_info/get/ وہ اسکوپس دکھاتا ہے جو ٹوکن کے پاس ہوں۔
easyCoexistence TikTok اکاؤنٹ اونر سے اس کی ایپ کی تمام اجازتیں ایک ہی سائن ان میں مانگتا ہے، تاکہ Claude، ChatGPT یا آپ کا اپنا کوڈ اس کے ٹولز کے ذریعے پبلش کر سکے، کمنٹس سنبھال سکے اور انسائٹس پڑھ سکے، اور get_social_credentials آپ کے اپنے کوڈ کو Accounts API کے دیگر اینڈ پوائنٹس کے لیے وہی ٹوکن دیتا ہے۔
TikTok Accounts کا اسکوپس ID، یعنی وہ پہلی سطح کی اجازت جو Accounts API کے پروفائل، پوسٹ، کمنٹ اور پبلشنگ اینڈ پوائنٹس سے اوپر ہے۔
وہ اسکوپس جو اکاؤنٹ کے پروفائل ڈیٹا میں is_business_account اور has_advanced_access کے پیچھے ہے۔
وہ اسکوپس جسے اکاؤنٹ اونر نے دینا اور فعال رکھنا ضروری ہے، تاکہ ایپ comment.update ویب ہک ایونٹس وصول کر سکے۔
وہ اسکوپس جو پوسٹ کو شائع کرنے کے بجائے ڈرافٹ کے طور پر اپ لوڈ کرنے کے لیے درکار ہے۔
TikTok کی جانب سے ڈویلپر ایپ کی اجازتوں میں تبدیلی کے ریویو کے لیے لگنے والے کاروباری دن۔
TikTok کی اجازتوں کی دو تہیں کون سی ہیں؟
ایپ کی اجازتیں اور ٹوکن اسکوپس۔ ایپ کی اجازتیں My Apps، ایپ، Scope of permission کے تحت منتخب کی جاتی ہیں، اور TikTok انہیں ریویو کرتا ہے؛ یہ تین سطحوں میں آتی ہیں، اور پہلی سطح کی اجازت اس کے نیچے کے ہر اینڈ پوائنٹ کو کور کرتی ہے۔ ٹوکن اسکوپس وہ ہیں جو اکاؤنٹ اونر نے ایپ کی اجازت دیتے وقت منظور کیے، اور ہر ٹوکن کے ساتھ scope کے طور پر ایک کاما سے جڑی سٹرنگ میں واپس آتے ہیں۔ کال کے لیے ایپ کی اس اینڈ پوائنٹ پر اجازت درکار ہے، اور بعض رسپانس فیلڈز کے لیے ٹوکن پر اسکوپ بھی ضروری ہے۔
کون سی ایپ کی اجازت ہر اینڈ پوائنٹ کھولتی ہے؟
TikTok کا API reference ہر Accounts API اینڈ پوائنٹ کے لیے وہ اجازت بتاتا ہے جو TikTok Accounts کے تحت اسے کھولتی ہے، یا کوئی نہیں۔ اس کا permission scope reference اور ویب ہک گائیڈ انہی گروپس کو Business User، Business Media، Business Comment اور Business Content کہتے ہیں، اس لیے دونوں ناموں کے سیٹ کی توقع رکھیں:
کون سے ٹوکن اسکوپس کون سی فیلڈز کھولتے ہیں؟
TikTok کے /business/get/ اور /business/video/list/ کی دستاویزات ہر رسپانس فیلڈ کے لیے درکار اجازت بتاتی ہیں، اور دو دیگر خصوصیات کا اپنا الگ اسکوپ ہے:
- user.info.basic:
display_nameاورprofile_imageکھولتا ہے۔ - user.info.username: username، جس کے لیے جون 2023 تک user.info.basic درکار تھا۔
- user.info.profile:
profile_deep_link،bio_descriptionاورis_verifiedکھولتا ہے۔ - user.info.stats:
following_count،followers_count،total_likesاورvideos_countکھولتا ہے۔ - user.account.type:
is_business_accountاورhas_advanced_accessکھولتا ہے۔ - user.insights: روزانہ کے اکاؤنٹ میٹرکس اور عمر، جنس، ملک اور شہر کے لحاظ سے فالوورز کی تفصیل کھولتا ہے۔
- video.list: پوسٹ کی فیلڈز جیسے
item_id، caption،share_url، likes، comments، shares، reach اورvideo_viewsکھولتا ہے۔ - video.insights: واچ ٹائم، مکمل دیکھنے کی شرح، ریٹینشن، ٹریفک کے ذرائع، ناظرین کی تفصیل اور پوسٹ کے ذریعے آنے والے کلکس کھولتا ہے۔
- comment.list: comment.update ویب ہک، جسے TikTok ایپ کے اندر کے مواد کے کمنٹس اور جوابات پڑھنے کے طور پر بیان کرتا ہے۔
- video.upload:
upload_to_draftیاis_draftکے ساتھ ویڈیو یا فوٹو پوسٹ کو ڈرافٹ کے طور پر اپ لوڈ کرنا۔
ٹوکن کے اسکوپس کیسے دیکھیں؟
/tt_user/token_info/get/ سے پوچھیں، جو app_id اور ایکسیس ٹوکن لیتا ہے اور ٹوکن کا scope اور اکاؤنٹ کا creator_id واپس کرتا ہے۔ TikTok کی مثالی اسکوپ سٹرنگز میں video.publish اور comment.list.manage بھی شامل ہیں، جن کے نام پبلشنگ اور کمنٹ مینجمنٹ اینڈ پوائنٹس سے ملتے ہیں، حالانکہ اس کی دستاویزات کسی فیلڈ کو ان میں سے کسی سے نہیں جوڑتیں۔
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/token_info/get/' \
-H 'Content-Type: application/json' \
-d '{"app_id": "<APP_ID>", "access_token": "<ACCESS_TOKEN>"}'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"app_id": "<APP_ID>",
"creator_id": "<OPEN_ID>",
"scope": "video.publish,user.info.basic,video.list,user.insights,comment.list.manage,video.insights,comment.list"
}
}easyCoexistence کا TikTok کنکشن کیا مانگتا ہے؟
وہ اجازتیں جو اس کی ڈویلپر ایپ رکھتی ہے، سب TikTok کے رضامندی کے صفحے (consent page) پر دکھائی جاتی ہیں۔ easyCoexistence اکاؤنٹ اونر کو TikTok account holder authorization URL پر بھیجتا ہے جو TikTok کا پورٹل اس کی ایپ کے لیے بناتا ہے، جو پہلے ہی ان اجازتوں کا نام لیتا ہے، اور صرف اپنی ایک state ویلیو شامل کرتا ہے۔ اونر وہی منظور کرتا ہے جو TikTok دکھاتا ہے، اور TikTok کی واپس کی ہوئی اسکوپ سٹرنگ کنکشن کے ساتھ محفوظ کی جاتی ہے۔ اکاؤنٹ کے لیے easyCoexistence جو اینڈ پوائنٹس کال کرتا ہے:
- /business/get/ پروفائل، روزانہ کے میٹرکس اور فالوورز کی تفصیل کے لیے۔
- /business/video/list/ پوسٹس اور ان کے میٹرکس کے لیے۔
- /business/video/publish/، /business/photo/publish/ اور /business/publish/status/ پبلشنگ کے لیے۔
- /business/comment/list/، /business/comment/reply/create/، /business/comment/hide/ اور /business/comment/delete/ کمنٹس کے لیے۔
- /business/webhook/update/، ایپ کی سطح پر، کمنٹ ویب ہک کے لیے۔
مستقبل میں نئی اجازت کیسے شامل کریں؟
دو مرحلوں میں، ہر تہہ کے لیے ایک۔ ایپ کے لیے My Apps، ایپ، Scope of permission کھولیں، اسے ایڈٹ کریں، ایک ایسی وجہ دیں جو نئے اسکوپس سے مطابقت رکھتی ہو اور سبمٹ کریں؛ TikTok کا ریویو دو سے تین کاروباری دن لے سکتا ہے، اور 20 مارچ 2026 سے وہ درخواست جس میں TikTok Accounts شامل ہو، پہلے Accounts API Access Application Form مانگتی ہے۔ ٹوکن کے لیے اکاؤنٹ اونر ایپ کو دوبارہ اجازت دیتا ہے، کیونکہ ٹوکن وہ اسکوپس رکھتا ہے جو جاری ہونے کے وقت منظور ہوئے تھے۔
جب اجازت غائب ہو تو کیا ہوتا ہے؟
کال کے لیے TikTok کا ایرر کوڈ 40001 ہے، یعنی متعلقہ آپریشن کے لیے اجازت نہیں، اور اس کا حل permission scope reference کی طرف اشارہ کرتا ہے۔ فیلڈ کے لیے دستاویزات اسے تب تک دستیاب بناتی ہیں جب اکاؤنٹ اونر اس کا اسکوپ دے دے، اور ان کا حل یہ ہے کہ اونر اسی اسکوپ کے ساتھ ایپ کو دوبارہ اجازت دے۔ پوچھنے سے پہلے /tt_user/token_info/get/ سے ٹوکن کا scope جانچیں۔
عام غلطیاں
- یہ سمجھنا کہ کنکشن شدہ اکاؤنٹس کو خود بخود نئی ایپ اجازت مل جائے گی۔ ان کے ٹوکن اجازت کے وقت منظور شدہ اسکوپس رکھتے ہیں، جب تک ہر اونر ایپ کو دوبارہ اجازت نہ دے۔
- user.account.type کے بغیر is_business_account کی درخواست کرنا۔ TikTok یہ فیلڈ اور has_advanced_access صرف ان ٹوکنز کے لیے دستیاب کرتا ہے جن کے پاس یہ اسکوپ ہو۔
- comment.list کے بغیر comment.update کا انتظار کرنا۔ TikTok کمنٹ ایونٹس صرف اس وقت بھیجتا ہے جب اس اسکوپ کے ساتھ اونر کی اجازت برقرار ہو۔
- ٹوکن میں ایپ کی اجازت کے نام تلاش کرنا۔ اسکوپ سٹرنگ video.list جیسے نام استعمال کرتی ہے، جبکہ Get Account Media جیسے نام ایپ کی سیٹنگز میں ہوتے ہیں۔
فی کنکشن فی مہینہ US$ 9 سے US$ 0.75 تک، کنکشن بڑھنے کے ساتھ کم ہوتی ہوئی، پہلے 3 دن فری ٹرائل کے ساتھ۔
اکثر پوچھے جانے والے سوالات
TikTok API for Business کون سے اسکوپس استعمال کرتا ہے؟
ٹوکن اسکوپس جیسے user.info.basic، user.info.stats، user.insights، video.list، video.insights، comment.list اور video.upload، جو اکاؤنٹ اونر ایپ کی TikTok Accounts اجازتوں کے علاوہ دیتا ہے۔
TikTok کے کمنٹ ویب ہک کے لیے کون سی اجازتیں درکار ہیں؟
ایپ کو TikTok Accounts اور Business Comment درکار ہیں، اور اکاؤنٹ اونر کو comment.list دینا ہوگا۔ اگر یہ اجازت ختم ہو جائے یا واپس لے لی جائے تو ایونٹس رک جاتے ہیں۔
کیا نیا TikTok اسکوپ پہلے سے جاری ٹوکنز پر لاگو ہوتا ہے؟
نہیں۔ ٹوکن وہ اسکوپس رکھتا ہے جو جاری ہونے کے وقت منظور ہوئے تھے، اس لیے نیا شامل کرنے کے لیے اکاؤنٹ اونر ایپ کو دوبارہ اجازت دیتا ہے۔
TikTok نئی اجازت کی منظوری میں کتنا وقت لیتا ہے؟
TikTok کہتا ہے کہ اجازت میں تبدیلی کا ریویو دو سے تین کاروباری دن لے سکتا ہے، اور جو درخواستیں TikTok Accounts شامل کریں انہیں پہلے Accounts API Access Application Form درکار ہے۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ