התחברותהתחילו תקופת ניסיון
easyCoexistence ממשקי API רשמיים

הרשאות ב-TikTok API for Business: מה פותחת כל הרשאה

ה-API for Business של TikTok מעניק גישה בשתי שכבות. לאפליקציית המפתחים יש הרשאות תחת 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.

18000000

מזהה ההיקף של TikTok Accounts, ההרשאה ברמה הראשונה שמעל נקודות הקצה של Accounts API לפרופיל, לפוסטים, לתגובות ולפרסום.

user.account.type

ההיקף שנדרש עבור is_business_account ועבור has_advanced_access בנתוני הפרופיל של החשבון.

comment.list

ההיקף שבעל החשבון חייב להעניק ולשמור פעיל כדי שהאפליקציה תקבל אירועי וובהוק (Webhook) של comment.update, כל עוד ההיקף תקף.

video.upload

ההיקף שהאסימון צריך כדי להעלות פוסט כטיוטה במקום לפרסם אותו.

2 to 3 days

מספר ימי העסקים שבדיקת TikTok לשינוי בהרשאות אפליקציית מפתחים עשויה להימשך.

מהן שתי השכבות של ההרשאות?

הרשאות אפליקציה והיקפי אסימון. הרשאות האפליקציה נבחרות תחת My Apps, האפליקציה, Scope of permission, ו-TikTok בודקת אותן; יש שלוש רמות, ולהרשאה ברמה הראשונה יש כיסוי על כל נקודת קצה מתחתיה. היקפי האסימון הם מה שבעל החשבון אישר בעת ההרשאה לאפליקציה, ומוחזרים כמחרוזת scope אחת מופרדת בפסיקים, עם כל אסימון. קריאה דורשת הרשאת אפליקציה לנקודת הקצה שלה, וחלק משדות התגובה דורשים גם היקף על האסימון.

איזו הרשאת אפליקציה פותחת כל נקודת קצה?

ה-API for Business של TikTok מפרט, לכל נקודת קצה של Accounts API, את ההרשאה תחת TikTok Accounts שפותחת אותה, או ללא הרשאה כלל. בהפניה להיקפי ההרשאות שלו ובמדריך לוובהוקים הוא קורא לאותן קבוצות Business User, Business Media, Business Comment ו-Business Content, כך שכדאי לצפות לשני סטים של שמות:

Account User/business/get/: profile data and account insights
Get Account Media/business/video/list/: the account's posts and their metrics
Video Publish/business/video/publish/, /business/publish/status/, /business/video/settings/, hashtag suggestions and location tags
Photo Publish/business/photo/publish/
Get Business Comment/business/comment/list/ and /business/comment/reply/list/
Manage Account CommentCreating, replying to, liking, hiding and deleting comments, and comment image uploads
Business Benchmark/business/benchmark/: benchmarks for a business category
No permission needed/tt_user/token_info/get/, the URL property endpoints and the webhook configuration endpoints

אילו היקפי אסימון פותחים כל שדה?

ההפניות של TikTok לנקודות הקצה /business/get/ וגם /business/video/list/ מציינות הרשאה נדרשת לכל שדה בתגובה, ושתי תכונות נוספות מציינות היקף משלהן:

  • user.info.basic: display_name וגם profile_image, כלומר שם התצוגה והתמונה.
  • user.info.username: username, שהצריך את user.info.basic עד יוני 2023.
  • 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, ששמותיהם תואמים לנקודות הפרסום ולניהול התגובות, אף שההפניות של TikTok אינן מקשרות שום שדה לאף אחד מהם.

Read the scopes an access token carries
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. easyCoexistence שולחת את בעל החשבון לכתובת ה-URL לאישור בעל חשבון TikTok, שהפורטל של 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, אין הרשאה לביצוע הפעולה הקשורה, והתיקון מפנה להפניה להיקפי ההרשאות. לשדה, ההפניות זמינות רק לאחר שבעל החשבון העניק את ההיקף שלו, והתיקון הוא לבקש מבעל החשבון לאשר שוב את האפליקציה עם ההיקף הזה. בודקים את היקף האסימון עם /tt_user/token_info/get/ לפני שפונים אל TikTok.

טעויות נפוצות

  • לצפות שחשבונות מחוברים יקבלו מעצמם הרשאת אפליקציה חדשה. האסימונים שלהם שומרים על ההיקפים שאושרו בעת ההרשאה, עד שכל בעל חשבון מאשר שוב את האפליקציה.
  • לבקש את is_business_account בלי user.account.type. השדה הזה וגם has_advanced_access זמינים רק לאסימונים שנושאים את ההיקף הזה.
  • לחכות לאירועי comment.update בלי comment.list. אירועי תגובות נשלחים רק כל עוד ההרשאה של בעל החשבון עם ההיקף הזה נשארת בתוקף.
  • לחפש באסימון שמות הרשאות של האפליקציה. מחרוזת ההיקפים משתמשת בשמות כמו video.list, ושמות כמו Get Account Media שייכים להגדרות האפליקציה.
עושים את זה עם EasyCoexistence

US$ 9 עד US$ 0.75 לחיבור לחודש, יורד ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.

שאלות נפוצות

אילו היקפים ה-API for Business של TikTok משתמש בהם?

היקפי אסימון כגון 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, כתנאי ראשון.

המשיכו לקרוא

אסימוני גישה ל-TikTok API for Business: 24 שעות, רענון וביטולאיך TikTok API for Business מנפיק אסימוני חשבון: החלפת auth_code, אסימון גישה ל-24 שעות, אסימון רענון לשנה, חידוש וביטול.ה-API for Business של TikTok לעומת Content Posting APIמדוע ה-API for Business של TikTok ולא developers.tiktok.com: תגובות והוובהוק (Webhook) שלהן, תובנות, החשבונות שמתחברים וחידוש האסימונים.הגדרת וובהוקים ל-TikTok API for Businessאיך להירשם לוובהוקים של אפליקציית TikTok API for Business: /business/webhook/update/, אירועי VIDEO ו-COMMENT, כללי callback וחתימת Tiktok-Signature.מדדי סרטוני TikTok דרך ה-API: צפיות, זמן צפייה והשלמההמדדים לכל סרטון ש-TikTok API for Business מחזיר: צפיות, הגעה, זמן צפייה, שיעור צפייה מלאה, שימור צופים, מקורות תנועה ומדינות הצופים.נתונים דמוגרפיים של העוקבים ב-TikTok דרך ה-APIנתוני העוקבים שה-API של TikTok for Business מחזיר: גיל, מגדר, מדינה, עיר, פעילות שעתית וכלל 100 העוקבים.TikTok analytics API: תובנות חשבון ומדדי סרטוניםמדדי TikTok שמחזיר ה-API for Business: עוקבים, צפיות ולייקים לפי יום לחשבון, וצפיות, לייקים, תגובות ושיתופים לכל סרטון.

מחברים את הערוץ הראשון שלכם תוך שתי דקות.

בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.

  • 3 ימי ניסיון חינם
  • ביטול בכל עת
  • רק ממשקי API רשמיים
  • ניטור 24/7

נבדק ב-