כתובות 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 מוריד אותו, כך שהדומיין שלכם אינו דורש אימות.
מאז אותו מועד, TikTok דוחה כתובות וידאו שאינן על דומיין או קידומת URL מאומתים.
מאז אותו מועד, נקודות הקצה לנכסי URL דורשות גם את הסוד של אפליקציית המפתח.
בשדה property_type: 1 לדומיין, 2 לקידומת.
ערכי property_status הם pending, verified וגם not verified, שפירושו שהניסיון נכשל וצריך לחזור עליו.
מפתחים שפרסמו סרטונים לפני אותו מועד קיבלו אימות אוטומטי לדומיינים של כתובות הסרטונים שלהם.
גודל התמונה המרבי שנקודת הקצה /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 לכל סוג נכס:
| Domain | URL prefix | |
|---|---|---|
| What it is | A site you own, such as example.com or a subdomain | https:// plus a host, a path and a final /, such as https://www.example.com/videos/ |
| Proof | A DNS TXT record holding the signature | A file named file_name, holding the signature, uploaded under the prefix |
| Covers | URLs on the domain and its subdomains | URLs that begin with the prefix |
| Leaves out | The parent: verifying video.example.com leaves example.com unverified | Sibling paths: /folder/user/ leaves /folder/public/ unverified |
| Redirects | Not applicable | Not 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 פירושו שהניסיון נכשל.
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 מספק כתובת סרטון בדיקה שאינה דורשת אימות:
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 לא יכול להוריד את הקובץ והפוסט נכשל.
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 מוריד אותו לאחר מכן, עד שעה, ונכשל הפוסט אם הקישור מפסיק לעבוד.
מ-US$ 9 ועד US$ 0.75 לחיבור בחודש, יורד ככל שמוסיפים חיבורים, עם תקופת ניסיון של 3 ימים.
שאלות נפוצות
למה TikTok דורש כתובות מדיה מאומתות?
TikTok אומר שאימות הבעלות על כתובות וידאו עוזר לו לעמוד במדיניות שלו בנוגע לתוכן מוגן בזכויות יוצרים ולבטיחות המשתמשים.
האם דומיין מאומת של TikTok מכסה את תת-הדומיינים שלו?
כן. תת-דומיינים של דומיין מאומת נחשבים מאומתים, אבל הרשימה בנקודת הקצה /business/property/list/ מציגה אותם רק אם נוספו.
האם ה-API for Business של TikTok יכול לפרסם מקישור S3 או CDN?
כן, כשהקישור נמצא תחת דומיין או קידומת URL שהאפליקציה אימתה, למשל קידומת על bucket או נתיב CDN שבשליטתכם.
גם לפוסטי תמונות צריך כתובות מאומתות?
כן. נקודת הקצה של TikTok לתמונות קובעת שאי אפשר לפרסם פוסטי תמונות מכתובות תמונה שאינן מאומתות.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-