Γιατί σταματά να λειτουργεί η σύνδεση 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 ή τη δική σας πλατφόρμα.
Διάρκεια ζωής του access token λογαριασμού TikTok από το API για επιχειρήσεις. Το /tt_user/oauth2/refresh_token/ το ανανεώνει.
Διάρκεια ζωής του refresh token. Όταν λήξει, ο ιδιοκτήτης του λογαριασμού πρέπει να εξουσιοδοτήσει ξανά την εφαρμογή.
Κωδικός αποτυχίας όταν ο ιδιοκτήτης αφαιρεί την πρόσβαση της εφαρμογής ενώ το TikTok επεξεργάζεται μια ανάρτηση. Το TikTok λέει να μην γίνεται επανάληψη της κλήσης.
Συμβάντα που το TikTok σταματά να στέλνει για έναν λογαριασμό, όταν λήξει ή ανακληθεί η εξουσιοδότηση του ιδιοκτήτη.
Γιατί ενεργοποιείται το authorization.removed του TikTok for Developers: ο χρήστης αποσυνδέεται, ο λογαριασμός διαγράφεται, αλλάζει η ηλικία, υπάρχει απαγόρευση ή ο προγραμματιστής ανακαλεί την πρόσβαση.
Κάθε πόσο το easyCoexistence ελέγχει κάθε συνδεδεμένο λογαριασμό TikTok: ανανεώνει μόνο του το token των 24 ωρών και σας στέλνει email αν χρειάζεται νέα σύνδεση.
Γιατί σταματά να λειτουργεί η σύνδεση TikTok API;
Για λίγους λόγους, που οι περισσότεροι σχετίζονται με τα tokens του λογαριασμού ή με τη συναίνεση του ιδιοκτήτη. Κάποιοι διακόπτουν τη σύνδεση εντελώς, ενώ άλλοι την αφήνουν μισή λειτουργική: ορισμένες κλήσεις απορρίπτονται και οι υπόλοιπες απαντούν κανονικά:
Τι σφάλμα επιστρέφει κάθε αιτία και ποια είναι η λύση;
Το πεδίο code του TikTok ονομάζει τα περισσότερα, μέσα σε απάντηση HTTP 200 και όχι σε κατάσταση σφάλματος, ενώ η κατάσταση δημοσίευσης προσθέτει δική της αιτία αποτυχίας. Ο κωδικός 40100 μπαίνει στον πίνακα επειδή μια κλήση με περιορισμό ρυθμού μπορεί να μοιάζει με χαμένη σύνδεση. Τι σημαίνει το καθένα και η λύση του:
| What it means | The fix | |
|---|---|---|
| 40102 | The access token is past its 24 hours | Renew with the refresh token, store both new tokens, repeat the call |
| 40103 | The refresh token has expired | A new authorization by the owner; nothing renews it |
| 40104 | The request carried no access token | A bug in the request: send the Access-Token header |
| 40105 | The access token is invalid or incorrect | Check what was sent, renew, then ask the owner to authorize again |
| 40107 | The refresh token is invalid or incorrect | Send the refresh token from the latest response, or a new authorization |
| 40131 | Authentication failed at a token endpoint | Check the app ID and secret, then the code or the refresh token |
| 40001 | A permission or scope is missing | Add it to the app, then have the owner authorize again |
| auth_removed | Access was removed while a post was processing | No retry; publish again after a new authorization |
| 40100 | Throttled, not disconnected | Pause 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και τον ίδιο προορισμό συμβάντων.
Πώς να το ρυθμίσετε
- 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.
- 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.
- Check each accountMake one light call per account on a schedule and record any 40102, 40103, 40104 or 40105 against that account.
- 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.
- 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 συνεχίζει να λειτουργεί.
Από 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, και η Επανάληψη τις στέλνει αφού ξανασυνδεθεί ο λογαριασμός.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις