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

כתובות URL של מדיה ב-TikTok: דומיינים מאומתים וקידומות URL

ה-API for Business של TikTok מוריד מדיה של פוסטים מכתובות URL: video_url, custom_thumbnail_url והשדה photo_images. כל כתובת URL חייבת להימצא בתוך דומיין או קידומת URL שבעלותם אומתה על ידי אפליקציית המפתח. דומיין מאומת באמצעות רשומת DNS TXT, וקידומת באמצעות קובץ חתימה שמונח תחתיה, דרך נקודות הקצה /business/property/add/ וגם /business/property/verify/ עם מזהה האפליקציה והסוד שלה.

easyCoexistence מגישה את המדיה שלכם ל-TikTok מקידומת URL מאומתת משלה: publish_tiktok_post מקבל קישור HTTPS מ-Claude, מ-ChatGPT או מהקוד שלכם, ומזרים את הקובץ ממנו כש-TikTok מוריד אותו, כך שהדומיין שלכם אינו דורש אימות.

Nov 16, 2023

מאז אותו מועד, TikTok דוחה כתובות וידאו שאינן על דומיין או קידומת URL מאומתים.

Oct 15, 2025

מאז אותו מועד, נקודות הקצה לנכסי URL דורשות גם את הסוד של אפליקציית המפתח.

1 / 2

בשדה property_type: 1 לדומיין, 2 לקידומת.

0, 1, 2

ערכי property_status הם pending, verified וגם not verified, שפירושו שהניסיון נכשל וצריך לחזור עליו.

Apr 7, 2023

מפתחים שפרסמו סרטונים לפני אותו מועד קיבלו אימות אוטומטי לדומיינים של כתובות הסרטונים שלהם.

5 MB

גודל התמונה המרבי שנקודת הקצה /business/comment/image/upload/ מקבלת, כ-multipart form data, לתגובה או לתשובה.

אילו כתובות TikTok מוריד?

כל שדה מדיה בשתי נקודות הקצה לפרסום הוא כתובת ש-TikTok שולף בעצמו לאחר שקיבל את הקריאה, ולכן הקובץ חייב להישאר נגיש עד לסיום ההורדה:

  • video_url: הסרטון, שלפי ההמלצה של TikTok צריך להישאר תקף לפחות 30 דקות.
  • custom_thumbnail_url: תמונה שתשמש כשער הסרטון.
  • photo_images: עד 35 תמונות לפוסט של תמונות.
  • פסק זמן: TikTok נותן להורדה שעה, ואחריה הפוסט נכשל עם קוד video_pull_failed או photo_pull_failed לפי סוג הפוסט.

מה ההבדל בין דומיין לקידומת URL?

מה שמוכיחים שבבעלותכם, ולכן אילו כתובות נחשבות מאומתות. דומיין מתאים למדיה על שרת שבבעלותכם או שאתם שולטים בו; קידומת מתאימה לתיקייה על שרת שאפשר רק להעלות אליו קבצים. אלו הכללים של TikTok לכל סוג נכס:

DomainURL prefix
What it isA site you own, such as example.com or a subdomainhttps:// plus a host, a path and a final /, such as https://www.example.com/videos/
ProofA DNS TXT record holding the signatureA file named file_name, holding the signature, uploaded under the prefix
CoversURLs on the domain and its subdomainsURLs that begin with the prefix
Leaves outThe parent: verifying video.example.com leaves example.com unverifiedSibling paths: /folder/user/ leaves /folder/public/ unverified
RedirectsNot applicableNot followed; a prefix answering 3xx is invalid

איך מאמתים נכס?

בשתי קריאות שמאמתות באמצעות app_id והסוד של אפליקציית המפתח, במקום אסימון חשבון, והוכחת הבעלות נמצאת ביניהן:

  • הוספה: POST /business/property/add/ עם url_property_meta, שמכיל את property_type וגם url. התשובה נותנת signature, ובקידומת גם file_name, עם property_status שערכו 0, כשהנכס ממתין לאימות.
  • הוכחה: מניחים את החתימה ברשומת DNS TXT לדומיין, או בקובץ ציבורי בשם file_name, עם סיומת .txt אחת בלבד, תחת קידומת.
  • בדיקה: POST /business/property/verify/ עם אותו url_property_meta. property_status שערכו 1 פירושו מאומת, והערך 2 פירושו שהניסיון נכשל.
Add a URL prefix
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/property/add/' \
  -H 'Content-Type: application/json' \
  -d '{
    "app_id": "<APP_ID>",
    "secret": "<APP_SECRET>",
    "url_property_meta": { "property_type": 2, "url": "https://media.example.com/tiktok/" }
  }'

# data.url_property_info: url, property_type, property_status (0), signature, file_name

איך מציגים או מסירים נכסים?

GET /business/property/list/ עם app_id והסוד, וגם url_property_meta, מחזיר את url_property_info_list, וכל ערך בו כולל property_type, url, property_status, signature וגם file_name. תת-דומיינים של דומיין מאומת נחשבים מאומתים בלי קריאה משלהם, אבל מופיעים ברשימה רק אם נוספו. POST /business/property/delete/ עם app_id והסוד, וגם url_property_meta, מסיר נכס שהאפליקציה כבר לא בבעלותה או בשליטתה.

אפשר להעלות קובץ במקום כתובת?

לא לפוסטים. ה-Accounts API מפרסם מכתובות בלבד, כולל טיוטות, ונקודת ההעלה היחידה שלו, /business/comment/image/upload/, מקבלת תמונה לתגובה כ-multipart form data, בפורמט JPG, JPEG, WebP או PNG עד 5 MB, ומחזירה image_uri לתגובה או לתשובה. העלאה מקוטעת של קבצים שייכת ל-Content Posting API ב-developers.tiktok.com, API נפרד עם אפליקציות משלו, שיטת ההעברה שבו נקראת FILE_UPLOAD במערכת זו.

מה קורה עם כתובת שלא אומתה?

TikTok מסרב לפרסם ממנה. מדריך ה-API for Business מציין את הכלל לסרטונים ולתמונות, אבל אינו מציין קוד החזרה ייעודי, לכן קראו את הקוד וההודעה שבתשובה. ה-Content Posting API ב-developers.tiktok.com קורא לאותו מקרה url_ownership_unverified, עם HTTP 403. כדי לנסות את נקודת הקצה של הסרטונים לפני אימות נכס כלשהו, TikTok מספק כתובת סרטון בדיקה שאינה דורשת אימות:

TikTok's test video URL for /business/video/publish/
https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4

איך easyCoexistence מעבירה את המדיה שלכם ל-TikTok?

דרך קידומת URL מאומתת אחת משלה, https://easycoexistence.com/api/social/media/. publish_tiktok_post מקבל את הקישור שלכם ב-HTTPS, דוחה http:// לפני ששולח משהו, ונותן ל-TikTok קישור תחת הקידומת הזו, הכולל אסימון חתום המזהה את הקובץ שלכם, פג תוקף אחרי 6 שעות ושומר על הסיומת של הקובץ. כש-TikTok שולף אותו, easyCoexistence בודקת את האסימון, מוודאת שהקישור שלכם משתמש ב-HTTPS וכתובת ציבורית, ומזרימה את הקובץ ישירות מהקישור שלכם, כולל בקשות טווח והפניות, בלי לשמור אותו. אם הקישור שלכם נכשל, TikTok לא יכול להוריד את הקובץ והפוסט נכשל.

What TikTok receives in place of your link
Your link:       https://cdn.example.com/videos/launch.mp4
Sent to TikTok:  https://easycoexistence.com/api/social/media/<SIGNED_TOKEN>.mp4

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

  • אימות תת-דומיין ואירוח הקבצים בדומיין האב שלו. video.example.com מאומת מכסה את תת-הדומיינים שלו, לא את example.com עצמו.
  • הגשת קובץ האימות של הקידומת דרך הפניה. TikTok אינו עוקב אחרי הפניות לקידומת URL ומתייחס לתשובה 3xx כלא תקפה.
  • שמירת קובץ החתימה בשם name.txt.txt. TikTok רוצה ששם הקובץ יתאים לערך file_name, עם סיומת .txt אחת בלבד.
  • מחיקת הקובץ מיד אחרי קריאת הפרסום. TikTok מוריד אותו לאחר מכן, עד שעה, ונכשל הפוסט אם הקישור מפסיק לעבוד.
עושים את זה עם EasyCoexistence

מ-US$ 9 ועד US$ 0.75 לחיבור בחודש, יורד ככל שמוסיפים חיבורים, עם תקופת ניסיון של 3 ימים.

שאלות נפוצות

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

TikTok אומר שאימות הבעלות על כתובות וידאו עוזר לו לעמוד במדיניות שלו בנוגע לתוכן מוגן בזכויות יוצרים ולבטיחות המשתמשים.

האם דומיין מאומת של TikTok מכסה את תת-הדומיינים שלו?

כן. תת-דומיינים של דומיין מאומת נחשבים מאומתים, אבל הרשימה בנקודת הקצה /business/property/list/ מציגה אותם רק אם נוספו.

האם ה-API for Business של TikTok יכול לפרסם מקישור S3 או CDN?

כן, כשהקישור נמצא תחת דומיין או קידומת URL שהאפליקציה אימתה, למשל קידומת על bucket או נתיב CDN שבשליטתכם.

גם לפוסטי תמונות צריך כתובות מאומתות?

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

המשיכו לקרוא

איך מעלים סרטון ל-TikTok דרך ה-APIפרסמו סרטון ב-TikTok עם ה-API לעסקים: נקודת הקצה לפרסום, גוף ה-JSON, המזהה share_id שמוחזר והקריאה לסטטוס, ב-curl וב-Python.הגדרות פוסט ב-TikTok דרך ה-API: פרטיות, תגובות, Duet ו-Stitchההגדרות שנקודות הקצה לפרסום של TikTok מקבלות: פרטיות, תגובות, Duet, Stitch, תמונת שער, תוויות מותג ו-AI, והערכים שכל חשבון מאפשר.דרישות הסרטון של TikTok ל-API: פורמט, גודל ואורךהסרטונים ש-TikTok API for Business מפרסם: MP4, MOV או WebM, 3 עד 600 שניות, עד 1 GB, 23 עד 60 FPS, מכתובת ש-TikTok מורידה בעצמה.פוסטים של תמונות וקרוסלות ב-TikTok דרך ה-API: עד 35 תמונותאיך ה-API for Business של TikTok מפרסם פוסט תמונות: 1 עד 35 קבצי JPEG או WebP עד 20 MB כל אחד, כותרת, כיתוב ותמונת שער.סימון תוכן שנוצר ב-AI בטיקטוק דרך ה-APIאיך מסמנים סרטונים שנוצרו ב-AI דרך ה-API for Business של TikTok עם post_info.is_ai_generated, ומה דורשת מדיניות TikTok.איך לבדוק את סטטוס הפרסום של פוסט ב-TikTok דרך ה-APIאיך עוקבים אחר פוסט ב-TikTok שפורסם דרך ה-API: השדה share_id, הסטטוסים, מזהי הפוסטים וסיבות הכשל.

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

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

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

נבדק ב-