Ralat TikTok 40102: token akses telah tamat tempoh
Ralat TikTok 40102 bermaksud token akses yang dihantar bersama permintaan telah tamat tempoh, dan endpoint perlu dipanggil semula dengan token terkini. Token akses Accounts API sah selama sehari. Perbaharuinya dengan menghantar refresh token ke /tt_user/oauth2/refresh_token/, kemudian ulang panggilan. Refresh token itu sendiri sah selama setahun, selepas itu pemilik akaun memberi kebenaran semula kepada aplikasi.
easyCoexistence memperbaharui token TikTok 24 jam dengan refresh token secara automatik, sebelum tamat tempoh, supaya panggilan dari Claude, ChatGPT atau kod anda sendiri dihantar dengan token semasa.
Kod pulangan TikTok bagi token akses yang telah tamat tempoh; endpoint mesti dipanggil semula dengan yang terkini.
Tempoh sah token akses akaun TikTok daripada Accounts API.
Nilai expires_in, dalam saat, dalam contoh TikTok bagi token akses yang baharu dikeluarkan.
Tempoh sah refresh token; apabila ia tamat, pemilik mesti memberi kebenaran semula kepada aplikasi.
Apa maksud ralat 40102?
Token akses dalam header Access-Token telah melepasi tarikh luput. Apendiks kod pulangan TikTok menyenaraikan 40102 sebagai token akses yang tamat tempoh dan menyatakan endpoint perlu dipanggil semula dengan yang terkini. Penyelesaiannya ialah menggunakan token akses yang sah dan cuba semula.
Kod ini tiba dalam badan respons. Kebanyakan panggilan ke API for Business mengembalikan HTTP 200, dan kod pulangan, bukan status, menentukan sama ada panggilan berjaya.
Berapa lama token akses TikTok sah?
Sehari bagi API for Business. Accounts API mengeluarkan token akses akaun TikTok apabila aplikasi menukar kod kebenaran di /tt_user/oauth2/token/, dan respons memberikan tempohnya dalam expires_in, 86,400 saat dalam contoh TikTok. Respons yang sama turut mengandungi refresh token, yang sah selama setahun dan yang TikTok nasihatkan supaya disimpan untuk memperbaharui token akses. Token akses pengguna TikTok for Developers, yang digunakan oleh Content Posting API, sebaliknya sah selama 2 jam.
Bagaimana memperbaharuinya?
Hantar refresh token ke /tt_user/oauth2/refresh_token/ bersama ID dan rahsia aplikasi, dengan grant_type ditetapkan kepada refresh_token. Respons mengandungi token akses dan refresh token baharu: simpan kedua-duanya, hantar token akses baharu dalam header Access-Token mulai sekarang, dan ulang panggilan yang gagal. Memperbaharui sebelum sehari tamat menghalang panggilan sampai ke TikTok dengan token yang telah tamat tempoh.
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/oauth2/refresh_token/' \
-H 'Content-Type: application/json' \
-d '{
"client_id": "<APP_ID>",
"client_secret": "<SECRET>",
"grant_type": "refresh_token",
"refresh_token": "<REFRESH_TOKEN>"
}'
# data: access_token, expires_in (86400), refresh_token, refresh_token_expires_inBila pemilik perlu memberi kebenaran semula?
Apabila pembaharuan tidak lagi mungkin. Refresh token sah selama setahun, dan dokumentasi TikTok menyatakan bahawa apabila ia tamat, pembangun meminta pemilik akaun memberi kebenaran semula kepada aplikasi melalui aliran kebenaran. Pemilik juga boleh membatalkan kebenaran pada bila-bila masa dari aplikasi TikTok, di bawah Tetapan dan privasi, Keselamatan, Urus kebenaran aplikasi, dan kebenaran baharu ialah jalan kembali.
Kesilapan biasa
- Memperbaharui hanya selepas panggilan gagal. Token yang sah sehari akan tamat setiap hari, jadi perbaharui lebih awal dan elakkan panggilan sampai ke TikTok dengan token lama.
- Mengabaikan refresh token dalam respons pembaharuan. Rujukan TikTok menyatakan supaya ia disimpan untuk pembaharuan seterusnya, jadi simpan yang dikembalikan setiap kali pembaharuan.
- Hanya menyemak status HTTP. TikTok biasanya menjawab dengan HTTP 200 dan meletakkan 40102 dalam medan code, jadi semakan status sahaja membaca kegagalan sebagai kejayaan.
- Menyimpan salinan token di beberapa tempat. Memperbaharui satu salinan membiarkan yang lain habis tempoh dan gagal dengan 40102.
Jika TikTok tetap menolak token dengan 40102, 40104 atau 40105, sambungan itu serta-merta ditandakan untuk disambung semula dan anda menerima e-mel. Kod anda sendiri boleh mendapatkan token semasa daripada get_social_credentials, tanpa menyimpan salinan. Harga US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan percubaan percuma 3 hari pertama.
Soalan lazim
Apa maksud expires_in dalam respons token TikTok?
Ia ialah bilangan saat sebelum token akses tamat tempoh: 86,400, iaitu sehari, dalam contoh TikTok bagi token Accounts API yang baharu. Tambahkannya kepada masa respons untuk tahu bila perlu memperbaharui, sebelum 40102 berlaku.
Bolehkah token akses TikTok yang tamat tempoh diperbaharui?
Boleh, selagi refresh token masih sah. Hantarkannya ke /tt_user/oauth2/refresh_token/, dan TikTok memulangkan token akses baharu bersama refresh token.
Adakah ralat 40102 bermaksud akaun mesti disambung semula?
Tidak dengan sendirinya. Refresh token yang sah memperbaharui akses tanpa pemilik; kebenaran baharu hanya diperlukan apabila refresh token telah tamat tempoh atau pemilik telah membatalkan akses.
Mengapa respons HTTP 200 mengandungi ralat 40102?
Kod pulangan TikTok mengatasi status HTTP. Panggilan hanya berjaya jika kodnya 0, tidak kira apa yang tertera pada baris status.
Teruskan membaca
Sambungkan saluran pertama anda dalam masa dua minit.
Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.
- 3 hari percuma
- Batal bila-bila masa
- API rasmi sahaja
- Dipantau 24/7
Disahkan pada