ΣύνδεσηΞεκινήστε δωρεάν δοκιμή
easyCoexistence Επίσημα API

Scopes του TikTok API for Business: τι ξεκλειδώνει κάθε δικαίωμα

Το API for Business του TikTok χορηγεί πρόσβαση σε δύο επίπεδα. Η εφαρμογή προγραμματιστή κατέχει δικαιώματα στο TikTok Accounts, όπως Video Publish και Manage Account Comment, που ανοίγουν endpoints. Η εξουσιοδότηση του ιδιοκτήτη του λογαριασμού δίνει στο access token scopes, όπως user.insights και video.list, που καθορίζουν τα πεδία που επιστρέφονται. Το /tt_user/token_info/get/ εμφανίζει τα scopes που φέρει ένα token.

Το easyCoexistence ζητά από τον ιδιοκτήτη του λογαριασμού TikTok τα δικαιώματα που κατέχει η εφαρμογή του με μία μόνο είσοδο, ώστε το Claude, το ChatGPT ή δικός σας κώδικας να μπορούν να δημοσιεύουν, να διαχειρίζονται σχόλια και να διαβάζουν αναλύσεις μέσω των εργαλείων του.

18000000

Scope ID του TikTok Accounts, το δικαίωμα πρώτου επιπέδου πάνω από τα endpoints προφίλ, ανάρτησης, σχολίων και δημοσίευσης του Accounts API.

user.account.type

Scope πίσω από τα is_business_account και has_advanced_access στα δεδομένα προφίλ ενός λογαριασμού.

comment.list

Scope που πρέπει να χορηγήσει ο ιδιοκτήτης και να παραμένει ενεργό, ώστε η εφαρμογή να λαμβάνει comment.update webhook συμβάντα.

video.upload

Scope που χρειάζεται ένα token για να ανεβάσει ανάρτηση ως πρόχειρο αντί να τη δημοσιεύσει.

2 to 3 days

Εργάσιμες ημέρες που μπορεί να διαρκέσει η έγκριση της αλλαγής δικαιωμάτων μιας εφαρμογής προγραμματιστή από το TikTok.

Ποια είναι τα δύο επίπεδα δικαιωμάτων του TikTok;

Δικαιώματα εφαρμογής και scopes token. Τα δικαιώματα εφαρμογής επιλέγονται στο My Apps, στην εφαρμογή, στο Scope of permission, και το TikTok τα εξετάζει· έρχονται σε τρία επίπεδα, και ένα δικαίωμα πρώτου επιπέδου καλύπτει κάθε endpoint από κάτω του. Τα scopes του token είναι όσα ενέκρινε ο ιδιοκτήτης του λογαριασμού κατά την εξουσιοδότηση της εφαρμογής, και επιστρέφονται ως scope, μία συμβολοσειρά χωρισμένη με κόμματα, μαζί με κάθε token. Μια κλήση χρειάζεται το δικαίωμα της εφαρμογής για το endpoint της, και ορισμένα πεδία απόκρισης χρειάζονται επιπλέον ένα scope στο token.

Ποιο δικαίωμα εφαρμογής ανοίγει κάθε endpoint;

Η αναφορά του API του TikTok καταγράφει, για κάθε endpoint του Accounts API, το δικαίωμα κάτω από το TikTok Accounts που το ανοίγει, ή κανένα. Η αναφορά των δικαιωμάτων και ο οδηγός webhook του ονομάζουν τις ίδιες ομάδες 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

Ποια scopes του token ξεκλειδώνουν ποια πεδία;

Οι αναφορές του TikTok για τα /business/get/ και /business/video/list/ δίνουν ένα απαιτούμενο δικαίωμα για κάθε πεδίο απόκρισης, και δύο άλλες λειτουργίες ονομάζουν δικό τους scope:

  • 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 webhook, που το TikTok περιγράφει ως ανάγνωση των σχολίων και των απαντήσεων του περιεχομένου εντός εφαρμογής.
  • video.upload: ανέβασμα ανάρτησης βίντεο ή φωτογραφίας ως πρόχειρο, με upload_to_draft ή is_draft.

Πώς βλέπετε τα scopes ενός token;

Ρωτήστε το /tt_user/token_info/get/, που δέχεται το app_id και το access token και επιστρέφει το scope του token και το creator_id του λογαριασμού. Τα παραδείγματα συμβολοσειρών scope του TikTok περιλαμβάνουν επίσης τα video.publish και comment.list.manage, των οποίων τα ονόματα ταιριάζουν με τα endpoints δημοσίευσης και διαχείρισης σχολίων, αν και οι αναφορές του δεν συνδέουν κανένα πεδίο με κανένα από τα δύο.

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"
  }
}

Τι ζητά η σύνδεση TikTok του easyCoexistence;

Τα δικαιώματα που κατέχει η εφαρμογή προγραμματιστή του, όλα εμφανιζόμενα στη σελίδα συναίνεσης του TikTok. Το easyCoexistence στέλνει τον ιδιοκτήτη του λογαριασμού στη διεύθυνση εξουσιοδότησης του κατόχου λογαριασμού TikTok που δημιουργεί η πύλη του TikTok για την εφαρμογή του, η οποία ήδη ονομάζει αυτά τα δικαιώματα, και προσθέτει μόνο μια δική του τιμή state. Ο ιδιοκτήτης εγκρίνει όσα δείχνει το TikTok, και η συμβολοσειρά scope που επιστρέφει το TikTok αποθηκεύεται μαζί με τη σύνδεση. Τα endpoints που καλεί στη συνέχεια το 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/, σε επίπεδο εφαρμογής, για το webhook σχολίων.

Πώς προσθέτετε δικαίωμα αργότερα;

Σε δύο βήματα, ένα για κάθε επίπεδο. Για την εφαρμογή, ανοίξτε το My Apps, την εφαρμογή, το Scope of permission, επεξεργαστείτε το, δώστε αιτιολόγηση που ταιριάζει με τα νέα scopes και υποβάλετε· η έγκριση του TikTok μπορεί να διαρκέσει δύο με τρεις εργάσιμες ημέρες, και από τις 20 Μαρτίου 2026 ένα αίτημα που περιλαμβάνει το TikTok Accounts χρειάζεται πρώτα τη φόρμα Accounts API Access Application Form. Για το token, ο ιδιοκτήτης εξουσιοδοτεί ξανά την εφαρμογή, αφού ένα token κρατά τα scopes που εγκρίθηκαν όταν εκδόθηκε.

Τι συμβαίνει όταν λείπει ένα δικαίωμα;

Για μια κλήση, ο κωδικός επιστροφής του TikTok είναι 40001, χωρίς δικαίωμα για την εκτέλεση της σχετικής λειτουργίας, και η διόρθωσή του παραπέμπει στην αναφορά scope δικαιωμάτων. Για ένα πεδίο, οι αναφορές το καθιστούν διαθέσιμο μόνο αφού ο ιδιοκτήτης χορηγήσει το scope του, και η διόρθωσή τους είναι να εξουσιοδοτήσει ξανά ο ιδιοκτήτης την εφαρμογή με εκείνο το scope. Ελέγξτε το scope του token με το /tt_user/token_info/get/ πριν ζητήσετε κάτι.

Συνηθισμένα λάθη

  • Η αναμονή ότι οι συνδεδεμένοι λογαριασμοί θα αποκτήσουν μόνοι τους νέο δικαίωμα εφαρμογής. Τα tokens τους κρατούν τα scopes που εγκρίθηκαν κατά την εξουσιοδότηση, μέχρι ο κάθε ιδιοκτήτης να εξουσιοδοτήσει ξανά την εφαρμογή.
  • Η αίτηση για is_business_account χωρίς user.account.type. Το TikTok καθιστά διαθέσιμο αυτό το πεδίο και το has_advanced_access μόνο σε tokens που φέρουν εκείνο το scope.
  • Η αναμονή για comment.update χωρίς comment.list. Το TikTok στέλνει συμβάντα σχολίων μόνο όσο η εξουσιοδότηση του ιδιοκτήτη με εκείνο το scope παραμένει έγκυρη.
  • Η αναζήτηση στο token για ονόματα δικαιωμάτων εφαρμογής. Η συμβολοσειρά scope χρησιμοποιεί ονόματα όπως video.list, ενώ ονόματα όπως Get Account Media ανήκουν στις ρυθμίσεις της εφαρμογής.
Κάντε το με EasyCoexistence

Το get_social_credentials δίνει στον δικό σας κώδικα το ίδιο token για άλλα endpoints του Accounts API. Από US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, μειούμενα όσο προσθέτετε συνδέσεις, με τις πρώτες 3 ημέρες δωρεάν.

Συχνές ερωτήσεις

Ποια scopes χρησιμοποιεί το TikTok API for Business;

Scopes του token όπως user.info.basic, user.info.stats, user.insights, video.list, video.insights, comment.list και video.upload, που χορηγεί ο ιδιοκτήτης του λογαριασμού πάνω από τα δικαιώματα TikTok Accounts της εφαρμογής.

Ποια δικαιώματα χρειάζεται το webhook σχολίων του TikTok;

Η εφαρμογή χρειάζεται TikTok Accounts και Business Comment, και ο ιδιοκτήτης πρέπει να χορηγήσει το comment.list. Τα συμβάντα σταματούν αν λήξει ή ανακληθεί αυτή η εξουσιοδότηση.

Ισχύει ένα νέο scope του TikTok για tokens που έχουν ήδη εκδοθεί;

Όχι. Ένα token κρατά τα scopes που εγκρίθηκαν όταν εκδόθηκε, οπότε ο ιδιοκτήτης του λογαριασμού εξουσιοδοτεί ξανά την εφαρμογή για να προσθέσει ένα νέο.

Πόσο χρόνο χρειάζεται το TikTok για να εγκρίνει ένα νέο δικαίωμα;

Το TikTok λέει ότι η εξέταση μιας αλλαγής δικαιώματος μπορεί να διαρκέσει δύο με τρεις εργάσιμες ημέρες, και τα αιτήματα που προσθέτουν πρώτα το TikTok Accounts χρειάζονται τη φόρμα Accounts API Access Application Form.

Συνεχίστε την ανάγνωση

Tokens πρόσβασης του TikTok API for Business: 24 ώρες, ανανέωση και ανάκλησηΠώς το TikTok API for Business εκδίδει tokens λογαριασμού: ανταλλαγή του auth_code, πρόσβαση 24 ωρών, refresh token, ανανέωση και ανάκληση.TikTok API for Business έναντι του Content Posting APIΓιατί το API for Business της TikTok και όχι το developers.tiktok.com: σχόλια και webhook, στατιστικές, συνδέσεις λογαριασμών και ανανέωση tokens.Ρύθμιση των webhooks του TikTok API for BusinessΕγγραφή εφαρμογής TikTok API for Business σε webhooks: /business/webhook/update/, γεγονότα VIDEO και COMMENT, κανόνες callback και Tiktok-Signature.Μετρικές βίντεο TikTok μέσω του API: προβολές, χρόνος θέασης και ολοκλήρωσηΜετρικές ανά βίντεο από το API for Business του TikTok: προβολές, εμβέλεια, χρόνος θέασης, ολοκλήρωση, πηγές επισκεψιμότητας και χώρες θεατών.Δημογραφικά κοινού TikTok μέσω του APIΤα δημογραφικά ακολούθων που επιστρέφει το API for Business του TikTok: ηλικία, φύλο, χώρα, πόλη, ωριαία δραστηριότητα και ο κανόνας των 100 ακολούθων.TikTok Analytics API: μετρήσεις λογαριασμού και βίντεοΟι μετρήσεις TikTok του API for Business: ακόλουθοι, προβολές και likes ανά ημέρα για λογαριασμό, και προβολές, likes, σχόλια και κοινοποιήσεις ανά βίντεο.

Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.

Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.

  • 3 ημέρες δωρεάν
  • Ακύρωση ανά πάσα στιγμή
  • Μόνο επίσημα API
  • Παρακολούθηση 24/7

Επαληθεύτηκε στις