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

Γιατί σταματά να λειτουργεί η σύνδεση TikTok API και πώς να τη διατηρείτε ενεργή

Η σύνδεση TikTok API για επιχειρήσεις σταματά να λειτουργεί όταν δεν ανανεώνεται το access token των 24 ωρών, λήγει το refresh token του ενός έτους, ο ιδιοκτήτης αφαιρεί την πρόσβαση της εφαρμογής ή το token που στέλνεται λείπει ή είναι λανθασμένο. Το TikTok αναφέρει τα σφάλματα του token ως 40102, 40103, 40104 και 40105. Η έγκαιρη ανανέωση, ο έλεγχος κάθε λογαριασμού με χρονοδιάγραμμα και το αίτημα προς τον ιδιοκτήτη για νέα εξουσιοδότηση πριν λήξει το έτος την κρατούν ενεργή.

Το easyCoexistence διατηρεί κάθε σύνδεση TikTok ενεργή μόνο του: ανανεώνει το token των 24 ωρών νωρίτερα, ελέγχει τον λογαριασμό περίπου κάθε 6 ώρες και, όταν το TikTok απορρίψει το token, σημειώνει το κανάλι ως Απαιτείται νέα σύνδεση και σας στέλνει email, για Claude, ChatGPT ή τη δική σας πλατφόρμα.

24 hours

Διάρκεια ζωής του access token λογαριασμού TikTok από το API για επιχειρήσεις. Το /tt_user/oauth2/refresh_token/ το ανανεώνει.

1 year

Διάρκεια ζωής του refresh token. Όταν λήξει, ο ιδιοκτήτης του λογαριασμού πρέπει να εξουσιοδοτήσει ξανά την εφαρμογή.

auth_removed

Κωδικός αποτυχίας όταν ο ιδιοκτήτης αφαιρεί την πρόσβαση της εφαρμογής ενώ το TikTok επεξεργάζεται μια ανάρτηση. Το TikTok λέει να μην γίνεται επανάληψη της κλήσης.

comment.update

Συμβάντα που το TikTok σταματά να στέλνει για έναν λογαριασμό, όταν λήξει ή ανακληθεί η εξουσιοδότηση του ιδιοκτήτη.

5 reasons

Γιατί ενεργοποιείται το authorization.removed του TikTok for Developers: ο χρήστης αποσυνδέεται, ο λογαριασμός διαγράφεται, αλλάζει η ηλικία, υπάρχει απαγόρευση ή ο προγραμματιστής ανακαλεί την πρόσβαση.

6 hours

Κάθε πόσο το easyCoexistence ελέγχει κάθε συνδεδεμένο λογαριασμό TikTok: ανανεώνει μόνο του το token των 24 ωρών και σας στέλνει email αν χρειάζεται νέα σύνδεση.

Γιατί σταματά να λειτουργεί η σύνδεση TikTok API;

Για λίγους λόγους, που οι περισσότεροι σχετίζονται με τα tokens του λογαριασμού ή με τη συναίνεση του ιδιοκτήτη. Κάποιοι διακόπτουν τη σύνδεση εντελώς, ενώ άλλοι την αφήνουν μισή λειτουργική: ορισμένες κλήσεις απορρίπτονται και οι υπόλοιπες απαντούν κανονικά:

Access token expired24 hours passed without a renewal, and calls return 40102
Refresh token expiredIts year ended: renewal returns 40103 until the owner signs in again
Access removedThe owner chose Remove access in TikTok, or the app revoked the token
Wrong tokenMissing from the request (40104), or invalid or incorrect (40105)
Missing permissionA call outside the granted permissions returns 40001
Account level changedData tied to Advanced Access or verification is no longer available
App access revokedTikTok can revoke an app's Accounts API access for misuse, without notice

Τι σφάλμα επιστρέφει κάθε αιτία και ποια είναι η λύση;

Το πεδίο code του TikTok ονομάζει τα περισσότερα, μέσα σε απάντηση HTTP 200 και όχι σε κατάσταση σφάλματος, ενώ η κατάσταση δημοσίευσης προσθέτει δική της αιτία αποτυχίας. Ο κωδικός 40100 μπαίνει στον πίνακα επειδή μια κλήση με περιορισμό ρυθμού μπορεί να μοιάζει με χαμένη σύνδεση. Τι σημαίνει το καθένα και η λύση του:

What it meansThe fix
40102The access token is past its 24 hoursRenew with the refresh token, store both new tokens, repeat the call
40103The refresh token has expiredA new authorization by the owner; nothing renews it
40104The request carried no access tokenA bug in the request: send the Access-Token header
40105The access token is invalid or incorrectCheck what was sent, renew, then ask the owner to authorize again
40107The refresh token is invalid or incorrectSend the refresh token from the latest response, or a new authorization
40131Authentication failed at a token endpointCheck the app ID and secret, then the code or the refresh token
40001A permission or scope is missingAdd it to the app, then have the owner authorize again
auth_removedAccess was removed while a post was processingNo retry; publish again after a new authorization
40100Throttled, not disconnectedPause the endpoint 5 minutes; the token still works

Πόσο διαρκούν τα tokens και πότε πρέπει να τα ανανεώνετε;

Στο API για επιχειρήσεις, το access token ισχύει 24 ώρες και το expires_in σε κάθε απάντηση δείχνει τα δευτερόλεπτα που απομένουν. Το refresh token ισχύει ένα έτος, με δική του αντίστροφη μέτρηση στο refresh_token_expires_in. Ανανεώστε αρκετά πριν τελειώσει η ημέρα, με χρονοδιάγραμμα και όχι αφού αποτύχει μια κλήση. Αποθηκεύστε το refresh token που επιστρέφει κάθε ανανέωση, καθώς η σημείωση του TikTok για αυτό το πεδίο είναι να το διατηρείτε. Αντιμετωπίστε το refresh_token_expires_in ως προθεσμία: στο παράδειγμα ανανέωσης του TikTok μετράει αντίστροφα αντί να ξεκινά νέο έτος.

Τι συμβαίνει όταν ο ιδιοκτήτης αφαιρεί την πρόσβαση της εφαρμογής;

Η εφαρμογή χάνει τα δικαιώματα του Accounts API που της έδωσε ο ιδιοκτήτης, οπότε οι κλήσεις με αυτό το token σταματούν να λειτουργούν, και το TikTok δεν τεκμηριώνει συμβάν του API για επιχειρήσεις που να το ανακοινώνει. Ο ιδιοκτήτης μπορεί να το κάνει οποτεδήποτε στην εφαρμογή TikTok, στις Ρυθμίσεις και απόρρητο, Ασφάλεια, Διαχείριση δικαιωμάτων εφαρμογής, Κατάργηση πρόσβασης. Τα σημάδια εμφανίζονται αλλού: μια ανάρτηση που επεξεργαζόταν το TikTok αποτυγχάνει με auth_removed, κάτι για το οποίο το TikTok λέει να μην γίνεται επανάληψη, και τα συμβάντα comment.update για τον λογαριασμό σταματούν να φτάνουν.

Τι αλλάζει στη σύνδεση όταν αλλάζει ο τύπος λογαριασμού;

Το TikTok δεν συνδέει κανένα σφάλμα token με αυτό στην τεκμηρίωσή του· αλλάζει αυτό που επιστρέφει το API. Δεδομένα όπως τα unique_video_views, daily_new_followers και audience_activity χρειάζονται Advanced Access ή επαληθευμένο λογαριασμό επιχείρησης, όπως και τα Mentions και τα API ανταλλαγής μηνυμάτων για επιχειρήσεις, ενώ το privacy_level_options ενός ιδιωτικού λογαριασμού δεν περιλαμβάνει το PUBLIC_TO_EVERYONE. Από τις 16 Οκτωβρίου 2026, το is_business_account δείχνει true μόνο για επαληθευμένους λογαριασμούς επιχείρησης και το has_advanced_access δείχνει το Advanced Access. Διαβάζοντας και τα δύο, κάτω από το user.account.type, βλέπετε την αλλαγή πριν μια κλήση σκοντάψει πάνω της.

Πώς εντοπίζετε μια ανενεργή σύνδεση πριν τη βρει ένας πελάτης;

Με ελέγχους που τρέχουν είτε δημοσιεύει κάποιος είτε όχι:

  • Μια ελαφριά κλήση ανά λογαριασμό με χρονοδιάγραμμα, όπως το /business/get/ με το πεδίο username, που επιστρέφει σφάλμα token μόλις το token σταματήσει να λειτουργεί.
  • Το /tt_user/token_info/get/, το οποίο δεν απαιτεί άδεια και επιστρέφει το scope του token, για να βεβαιωθείτε ότι τα δικαιώματα εξακολουθούν να καλύπτουν όσα καλούν οι λειτουργίες σας.
  • Το refresh_token_expires_in μετατρέπεται σε ημερομηνία κάθε φορά που φτάνει μια απάντηση, με υπενθύμιση στον ιδιοκτήτη εβδομάδες πριν.
  • Σιωπή στο comment.update για λογαριασμό που συνήθως λαμβάνει σχόλια, αφού το TikTok σταματά αυτά τα συμβάντα όταν λήξει ή ανακληθεί η εξουσιοδότηση.
  • Οι 40102, 40103, 40104 και 40105 μετρημένοι ανά λογαριασμό, ώστε ένας αποτυχημένος λογαριασμός να ξεχωρίζει ανάμεσα σε πολλούς.

Πώς επανασυνδέετε έναν λογαριασμό;

Εκτελώντας ξανά την εξουσιοδότηση για τον ίδιο λογαριασμό. Μοιραστείτε το URL εξουσιοδότησης για τον ιδιοκτήτη του λογαριασμού TikTok, με μια τιμή state που συνδέει την επιστροφή με τον λογαριασμό, και disable_auto_auth=1 αν ο ιδιοκτήτης πρέπει να ξαναδεί τη σελίδα δικαιωμάτων. Ανταλλάξτε το νέο auth_code στο /tt_user/oauth2/token/ μέσα στα 10 λεπτά του, και αντικαταστήστε και τα δύο αποθηκευμένα tokens. Το open_id είναι το ID του λογαριασμού ειδικό για την εφαρμογή στο TikTok, γι' αυτό αντιστοιχίστε τα νέα tokens με την αποθηκευμένη εγγραφή μέσω αυτού και μην δημιουργείτε δεύτερη.

Λήγουν με τον ίδιο τρόπο οι συνδέσεις του Content Posting API;

Όχι. Το TikTok for Developers, που καλύπτει τα Content Posting και Display APIs, ενημέρωσε τις σελίδες του για τα tokens στις 2 Νοεμβρίου 2026: τα access tokens χρηστών λήγουν μέσα σε 2 ώρες και τα refresh tokens ισχύουν 180 ημέρες από την πρώτη έκδοση. Τα refresh tokens περιστρέφονται, οπότε κάθε επιτυχής ανανέωση επιστρέφει νέο και ακυρώνει αμέσως αυτό που στάλθηκε. Αν ένας διακομιστής συνεχίσει να χρησιμοποιεί ένα αντικατασταθέν token, οι επόμενες ανανεώσεις αποτυγχάνουν και ο χρήστης πρέπει να εξουσιοδοτήσει ξανά. Ένα λανθασμένο refresh token αποτυγχάνει με invalid_grant, ένα λανθασμένο access token με access_token_invalid και HTTP 401, ενώ το webhook authorization.removed λέει γιατί αποχώρησε ένας χρήστης.

Τι κάνει το easyCoexistence για να διατηρεί ενεργή μια σύνδεση TikTok;

Ανανεώνει και ελέγχει μόνο του, και σας λέει πότε μόνο ο ιδιοκτήτης μπορεί να το διορθώσει:

  • Ανανέωση: πριν από μια κλήση, όταν απομένουν λιγότερα από 15 λεπτά, και κατά τον έλεγχο, όταν απομένουν λιγότερες από 8 ώρες, αποθηκεύοντας κάθε φορά το νέο refresh token και τη λήξη του.
  • Μία ανανέωση τη φορά ανά λογαριασμό, ώστε οι κλήσεις που φτάνουν ταυτόχρονα να τη μοιράζονται.
  • Ο έλεγχος: μια κλήση /business/get/ για το username του λογαριασμού περίπου κάθε 6 ώρες.
  • Ένα token που απορρίπτεται, 40102, 40104 ή 40105: το κανάλι εμφανίζει Απαιτείται νέα σύνδεση, ο ιδιοκτήτης λαμβάνει ένα email και μια πλατφόρμα λαμβάνει το channel.disconnected, με το μήνυμα του TikTok ως disconnected_reason.
  • Μέχρι τότε, τα εργαλεία απαντούν ότι ο λογαριασμός χρειάζεται επανασύνδεση, και μια προγραμματισμένη ανάρτηση αποτυγχάνει ως «reconnect» αντί να φτάσει στο TikTok.
  • Επανασύνδεση: πατήστε Σύνδεση TikTok στη σελίδα του καναλιού ή ξεκινήστε μια νέα συνεδρία σύνδεσης. Η νέα είσοδος κρατά το ίδιο account_id και τον ίδιο προορισμό συμβάντων.

Πώς να το ρυθμίσετε

  1. Store both tokens with datesSave access_token, refresh_token, open_id and scope, and turn expires_in and refresh_token_expires_in into dates as each response arrives.
  2. Renew ahead of the dayCall /tt_user/oauth2/refresh_token/ well before the 24 hours end, one renewal per account at a time, and keep the refresh token it returns.
  3. Check each accountMake one light call per account on a schedule and record any 40102, 40103, 40104 or 40105 against that account.
  4. Ask before the year endsSend the owner the authorization URL before refresh_token_expires_in runs out, and replace both tokens when the new code arrives.
  5. Reconnect on a token errorWhen renewal fails or the token is refused, stop calling for that account and send its owner the authorization URL.

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

  • Το να θεωρείτε ένα σιωπηλό webhook σχολίων σημάδι σιωπηλού λογαριασμού. Το TikTok σταματά το comment.update για έναν λογαριασμό μόλις τελειώσει η εξουσιοδότησή του, οπότε ελέγξτε τον λογαριασμό αντί να περιμένετε συμβάντα.
  • Η επανασύνδεση σε νέα εγγραφή. Αντιστοιχίστε τα νέα tokens μέσω του open_id, του ID του λογαριασμού ειδικού για την εφαρμογή στο TikTok, και ενημερώστε την αποθηκευμένη εγγραφή στη θέση της, διατηρώντας το ιστορικό και τις ρυθμίσεις της.
  • Η επανάληψη του 40103 ή του 40107 με το ίδιο refresh token. Καμία από τις δύο δεν λύνεται με επανάληψη: η πρώτη θέλει νέα εξουσιοδότηση, η δεύτερη το refresh token της τελευταίας απάντησης ή νέα εξουσιοδότηση.
  • Το να θεωρείτε τον κωδικό 40100 χαμένη σύνδεση. Είναι κλήση με περιορισμό ρυθμού· παύστε το endpoint για 5 λεπτά ή έως τις 00:00 UTC μετά από ημερήσιο όριο, και το ίδιο token συνεχίζει να λειτουργεί.
Κάντε το με EasyCoexistence

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

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

Μπορεί μια σύνδεση TikTok API να διαρκέσει για πάντα χωρίς τον ιδιοκτήτη;

Όχι. Η ανανέωση την κρατά το πολύ για το έτος του refresh token· μετά, η τεκμηριωμένη διαδρομή του TikTok είναι νέα εξουσιοδότηση από τον ιδιοκτήτη του λογαριασμού.

Γιατί απέτυχαν συνδέσεις TikTok για αρκετούς λογαριασμούς ταυτόχρονα;

Κοιτάξτε πρώτα την εφαρμογή και μετά τους λογαριασμούς: το 40113 σημαίνει ότι η εφαρμογή είναι αποκλεισμένη ή ότι το ID και το secret της δεν ταιριάζουν, και το TikTok μπορεί να ανακαλέσει την πρόσβαση της εφαρμογής στο Accounts API για κατάχρηση.

Μια νέα λειτουργία σημαίνει επανασύνδεση λογαριασμών TikTok;

Όταν χρειάζεται δικαίωμα (scope) που ο ιδιοκτήτης δεν έχει ποτέ δώσει, ναι. Ένα token κρατά τα scopes που εγκρίθηκαν κατά την εξουσιοδότηση, οπότε ο ιδιοκτήτης εξουσιοδοτεί ξανά την εφαρμογή για να προσθέσει ένα.

Τι συμβαίνει με τις προγραμματισμένες αναρτήσεις TikTok ενόσω ένας λογαριασμός χρειάζεται επανασύνδεση;

Στο easyCoexistence, αποτυγχάνουν ως «reconnect» τη στιγμή τους αντί να φτάσουν στο TikTok, ο ιδιοκτήτης λαμβάνει email, και η Επανάληψη τις στέλνει αφού ξανασυνδεθεί ο λογαριασμός.

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

Tokens πρόσβασης του TikTok API for Business: 24 ώρες, ανανέωση και ανάκλησηΠώς το TikTok API for Business εκδίδει tokens λογαριασμού: ανταλλαγή του auth_code, πρόσβαση 24 ωρών, refresh token, ανανέωση και ανάκληση.Αυτοματοποίηση στο TikTok: τι περιορίζει τους λογαριασμούς, επίσημο API έναντι botsΤι λένε οι όροι του TikTok για την αυτοματοποίηση, γιατί τα ανεπίσημα bots οδηγούν σε περιορισμούς και πώς να αυτοματοποιήσετε εντός κανόνων.Το TikTok API σε Python και Node.js: λειτουργικά παραδείγματαΚώδικας για το TikTok API for Business σε Python και Node.js: δημοσίευση και παρακολούθηση βίντεο, φωτογραφίες, σχόλια, insights και webhooks.Πώς συνδέετε έναν λογαριασμό TikTok σε ένα API ή σε AI agentΠώς ένας λογαριασμός TikTok συνδέεται σε API ή AI agent: η οθόνη εξουσιοδότησης του TikTok, τα δικαιώματα, η ροή στο dashboard και οι σύνδεσμοι.Scopes του TikTok API for Business: τι ξεκλειδώνει κάθε δικαίωμαΤα δικαιώματα του Accounts API του TikTok με τα δικά του ονόματα: τι ξεκλειδώνει το καθένα, τα scopes ανά πεδίο και πώς ελέγχετε ένα token.Οδηγός TikTok API για το 2026: από την εφαρμογή σας έως την πρώτη ανάρτησηΗ πορεία στο TikTok API το 2026, με τη σειρά: ποιο API, έλεγχος εφαρμογής, scopes, τα tokens, δημοσίευση, κατάσταση, σχόλια, webhooks, insights και όρια.

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

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

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

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