הרשאות ב-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.
מזהה ההיקף של TikTok Accounts, ההרשאה ברמה הראשונה שמעל נקודות הקצה של Accounts API לפרופיל, לפוסטים, לתגובות ולפרסום.
ההיקף שנדרש עבור is_business_account ועבור has_advanced_access בנתוני הפרופיל של החשבון.
ההיקף שבעל החשבון חייב להעניק ולשמור פעיל כדי שהאפליקציה תקבל אירועי וובהוק (Webhook) של comment.update, כל עוד ההיקף תקף.
ההיקף שהאסימון צריך כדי להעלות פוסט כטיוטה במקום לפרסם אותו.
מספר ימי העסקים שבדיקת TikTok לשינוי בהרשאות אפליקציית מפתחים עשויה להימשך.
מהן שתי השכבות של ההרשאות?
הרשאות אפליקציה והיקפי אסימון. הרשאות האפליקציה נבחרות תחת My Apps, האפליקציה, Scope of permission, ו-TikTok בודקת אותן; יש שלוש רמות, ולהרשאה ברמה הראשונה יש כיסוי על כל נקודת קצה מתחתיה. היקפי האסימון הם מה שבעל החשבון אישר בעת ההרשאה לאפליקציה, ומוחזרים כמחרוזת scope אחת מופרדת בפסיקים, עם כל אסימון. קריאה דורשת הרשאת אפליקציה לנקודת הקצה שלה, וחלק משדות התגובה דורשים גם היקף על האסימון.
איזו הרשאת אפליקציה פותחת כל נקודת קצה?
ה-API for Business של TikTok מפרט, לכל נקודת קצה של Accounts API, את ההרשאה תחת TikTok Accounts שפותחת אותה, או ללא הרשאה כלל. בהפניה להיקפי ההרשאות שלו ובמדריך לוובהוקים הוא קורא לאותן קבוצות 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, שהצריך את 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 אינן מקשרות שום שדה לאף אחד מהם.
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 שייכים להגדרות האפליקציה.
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, כתנאי ראשון.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-