TikTok media URLs: επαληθευμένα domains και URL prefixes
Το API for Business του TikTok κατεβάζει τα media των δημοσιεύσεων από URLs: το video_url, το custom_thumbnail_url και το photo_images. Κάθε URL πρέπει να βρίσκεται σε domain ή URL prefix του οποίου την ιδιοκτησία έχει επαληθεύσει η εφαρμογή του προγραμματιστή. Ένα domain επαληθεύεται με εγγραφή DNS TXT, ένα prefix με αρχείο υπογραφής τοποθετημένο κάτω από αυτό, μέσω των /business/property/add/ και /business/property/verify/ με το app ID και το secret της εφαρμογής.
Το easyCoexistence σερβίρει τα media σας στο TikTok από το δικό του επαληθευμένο URL prefix: το publish_tiktok_post δέχεται έναν σύνδεσμο HTTPS από το Claude, το ChatGPT ή τον δικό σας κώδικα και μεταδίδει το αρχείο από αυτόν όταν το TikTok το κατεβάζει, οπότε το domain σας δεν χρειάζεται επαλήθευση.
Από τότε, το TikTok απορρίπτει video URLs που δεν βρίσκονται σε επαληθευμένο domain ή URL prefix.
Από τότε, τα endpoints των ιδιοτήτων URL απαιτούν και το secret της εφαρμογής του προγραμματιστή.
Οι τιμές του property_type: 1 για domain, 2 για URL prefix.
Οι τιμές του property_status: pending, verified, και μη επαληθευμένο, όταν η προσπάθεια απέτυχε και πρέπει να επαναληφθεί.
Όσοι δημοσίευσαν βίντεο πριν από τότε είχαν τα domains των video URLs τους ορισμένα αυτόματα ως επαληθευμένα.
Το μέγιστο μέγεθος εικόνας που δέχεται το /business/comment/image/upload/, ως multipart form data, για σχόλιο ή απάντηση.
Ποια URLs κατεβάζει το TikTok;
Κάθε πεδίο media στα δύο endpoints δημοσίευσης είναι ένα URL που το ίδιο το TikTok κατεβάζει μόνο του αφού αποδεχτεί την κλήση, άρα το αρχείο πρέπει να παραμένει προσβάσιμο μέχρι να ολοκληρωθεί η λήψη:
video_url: το βίντεο, για το οποίο το TikTok προτείνει να παραμένει έγκυρο τουλάχιστον 30 λεπτά.custom_thumbnail_url: μια εικόνα που χρησιμοποιείται ως εξώφυλλο του βίντεο.photo_images: έως 35 εικόνες για μια ανάρτηση φωτογραφιών.- Χρονικό όριο: το TikTok δίνει στη λήψη μία ώρα, και μετά αποτυγχάνει την ανάρτηση με
video_pull_failedήphoto_pull_failed.
Ποια είναι η διαφορά ανάμεσα σε domain και URL prefix;
Τι αποδεικνύετε ότι κατέχετε, και άρα ποια URLs μετράνε ως επαληθευμένα. Ένα domain ταιριάζει σε media σε host που κατέχετε ή ελέγχετε· ένα prefix ταιριάζει σε φάκελο σε host όπου μπορείτε μόνο να ανεβάζετε αρχεία. Οι κανόνες του 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 και το secret της εφαρμογής του προγραμματιστή αντί για token λογαριασμού, με την απόδειξη να τοποθετείται ανάμεσά τους:
- Προσθήκη: POST /business/property/add/ με
url_property_meta, που περιέχειproperty_typeκαι url· η απάντηση δίνει signature, καιfile_nameγια prefix, μεproperty_status0. - Απόδειξη: βάλτε την υπογραφή σε εγγραφή DNS TXT για domain, ή σε δημόσιο αρχείο με όνομα
file_name, με μία μόνο κατάληξη .txt, κάτω από ένα prefix. - Έλεγχος: POST /business/property/verify/ με το ίδιο
url_property_meta·property_status1 σημαίνει επαληθευμένο, και 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 και secret επιστρέφει το url_property_info_list, με κάθε εγγραφή να περιέχει property_type, url, property_status, signature και file_name. Τα subdomains ενός επαληθευμένου domain μετράνε ως επαληθευμένα χωρίς δική τους κλήση, αλλά εμφανίζονται στη λίστα μόνο αν προστέθηκαν. Το POST /business/property/delete/ με app_id, secret και url_property_meta αφαιρεί μια ιδιότητα που η εφαρμογή δεν κατέχει ή δεν ελέγχει πια.
Μπορείτε να ανεβάσετε αρχείο αντί για URL;
Όχι για αναρτήσεις. Το Accounts API δημοσιεύει μόνο από URLs, και τα πρόχειρα συμπεριλαμβάνονται, ενώ το μοναδικό του endpoint μεταφόρτωσης, το /business/comment/image/upload/, δέχεται εικόνα σχολίου ως multipart form data, σε JPG, JPEG, WebP ή PNG έως 5 MB, και επιστρέφει ένα image_uri για σχόλιο ή απάντηση. Η μεταφόρτωση σε τμήματα ανήκει στο Content Posting API στο developers.tiktok.com, ένα χωριστό API με δικές του εφαρμογές, όπου η μέθοδος μεταφοράς λέγεται FILE_UPLOAD.
Τι γίνεται με ένα URL που δεν είναι επαληθευμένο;
Το TikTok αρνείται να δημοσιεύσει από αυτό. Η αναφορά του API for Business διατυπώνει τον κανόνα για βίντεο και φωτογραφίες αλλά δεν ονομάζει δικό της κωδικό απάντησης, οπότε διαβάστε τον κωδικό και το μήνυμα στην απάντηση. Το Content Posting API στο developers.tiktok.com ονομάζει την ίδια περίπτωση url_ownership_unverified, με HTTP 403. Για να δοκιμάσετε το endpoint βίντεο πριν επαληθευτεί οποιαδήποτε ιδιότητα, το TikTok δημοσιεύει ένα δοκιμαστικό URL βίντεο που δεν χρειάζεται επαλήθευση:
https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4Πώς φτάνουν τα media σας στο TikTok μέσω του easyCoexistence;
Μέσω ενός δικού του επαληθευμένου URL prefix, του https://easycoexistence.com/api/social/media/. Το publish_tiktok_post δέχεται τον σύνδεσμο HTTPS σας, απορρίπτει το http:// πριν σταλεί οτιδήποτε, και δίνει στο TikTok έναν σύνδεσμο κάτω από αυτό το prefix, με υπογεγραμμένο token που ονομάζει το αρχείο σας, λήγει σε 6 ώρες και διατηρεί την κατάληξη του αρχείου σας. Όταν το TikTok τον ανακτά, το easyCoexistence ελέγχει το token, επιβεβαιώνει ότι ο σύνδεσμός σας χρησιμοποιεί HTTPS σε δημόσια διεύθυνση, και μεταδίδει το αρχείο απευθείας από τον σύνδεσμό σας, συμπεριλαμβανομένων των range requests και των ανακατευθύνσεων, χωρίς να το αποθηκεύει. Αν ο σύνδεσμός σας αποτύχει, το TikTok δεν μπορεί να κατεβάσει το αρχείο και η ανάρτηση αποτυγχάνει.
Your link: https://cdn.example.com/videos/launch.mp4
Sent to TikTok: https://easycoexistence.com/api/social/media/<SIGNED_TOKEN>.mp4Συνηθισμένα λάθη
- Επαλήθευση ενός subdomain και φιλοξενία των αρχείων στο γονικό του domain. Ένα επαληθευμένο video.example.com καλύπτει τα δικά του subdomains, όχι το ίδιο το example.com.
- Σερβίρισμα του αρχείου υπογραφής του prefix μέσω ανακατεύθυνσης. Το TikTok δεν ακολουθεί ανακατευθύνσεις για URL prefix και θεωρεί την απάντηση 3xx άκυρη.
- Αποθήκευση του αρχείου υπογραφής ως name.txt.txt. Το TikTok απαιτεί το όνομα του αρχείου να ταιριάζει με το file_name, με μία μόνο κατάληξη .txt.
- Διαγραφή του αρχείου αμέσως μετά την κλήση δημοσίευσης. Το TikTok το κατεβάζει μετά, για έως μία ώρα, και αποτυγχάνει την ανάρτηση αν ο σύνδεσμος σταματήσει να λειτουργεί.
US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και οι πρώτες 3 ημέρες δωρεάν.
Συχνές ερωτήσεις
Γιατί το TikTok απαιτεί επαληθευμένα URLs media;
Το TikTok λέει ότι η επαλήθευση της ιδιοκτησίας των video URLs το βοηθά να συμμορφώνεται με τις πολιτικές του για περιεχόμενο με δικαιώματα πνευματικής ιδιοκτησίας και την ασφάλεια των χρηστών.
Καλύπτει ένα επαληθευμένο domain του TikTok τα subdomains του;
Ναι. Τα subdomains ενός επαληθευμένου domain μετράνε ως επαληθευμένα, αν και το /business/property/list/ τα εμφανίζει μόνο αν προστέθηκαν.
Μπορεί το API for Business του TikTok να δημοσιεύσει από σύνδεσμο S3 ή CDN;
Ναι, όταν ο σύνδεσμος βρίσκεται κάτω από domain ή URL prefix που έχει επαληθεύσει η εφαρμογή, όπως ένα prefix σε bucket ή διαδρομή CDN που ελέγχετε.
Χρειάζονται και οι αναρτήσεις φωτογραφιών επαληθευμένα URLs;
Ναι. Το endpoint φωτογραφιών του TikTok αναφέρει ότι οι αναρτήσεις φωτογραφιών δεν μπορούν να δημοσιευτούν από μη επαληθευμένα URLs φωτογραφιών.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις