MasukMulai uji coba gratis
easyCoexistence API resmi

TikTok API untuk Bisnis: token akses 24 jam, refresh, dan pencabutan

Token akses TikTok API untuk Bisnis berlaku 24 jam dan dikirim di header Access-Token. Aplikasi memperolehnya dengan menukar kode otorisasi pemilik di /tt_user/oauth2/token/, bersama token refresh yang berlaku setahun dan memperbarui akses di /tt_user/oauth2/refresh_token/. Cabut di /tt_user/oauth2/revoke/, dan lihat cakupan izin yang diberikan di /tt_user/token_info/get/.

easyCoexistence menukar kode saat akun TikTok masuk, memperbarui token 24 jam sebelum habis dan memeriksa akun sekitar setiap 6 jam, sehingga Claude, ChatGPT, atau kode Anda sendiri memanggil TikTok dengan token terkini, yang diserahkan get_social_credentials kepada skrip Anda.

24 hours

Masa berlaku token akses akun TikTok; setiap respons token menyebutkan sisa detik di expires_in.

1 year

Masa berlaku token refresh yang diterbitkan bersamanya; refresh_token_expires_in memberikan sisa detiknya.

10 minutes

Berapa lama kode otorisasi di URL redirect tetap berlaku; kode hanya bisa ditukar sekali.

open_id

ID khusus aplikasi milik akun, dikembalikan bersama setiap token dan dikirim sebagai business_id pada panggilan Accounts API.

Bearer

token_type yang dikembalikan TikTok: siapa pun yang memegang token dapat menggunakannya untuk mengakses sumber daya akun.

creator_id

ID akun yang dikembalikan /tt_user/token_info/get/ bersama cakupan token, dapat dipakai sebagai business_id pada panggilan Accounts API.

Bagaimana kode otorisasi sampai ke aplikasi Anda?

Melalui URL otorisasi pemilik akun TikTok, yang dibuat TikTok untuk aplikasi pengembang di My Apps, App Detail, Basic Information setelah aplikasi memiliki izin TikTok Accounts. Pemilik akun membukanya, meninjau izin dan menyetujuinya. Lalu TikTok mengarahkan browser ke URL redirect aplikasi dengan auth_code ditambahkan, serta nilai state apa pun yang dibawa URL otorisasi, dan kode itu berlaku 10 menit untuk satu kali penukaran.

  • URL redirect: absolut, diawali https://, diakhiri /, tanpa query string, anchor atau port, dan panjangnya 10 sampai 512 karakter.
  • Hingga 10 URL redirect per aplikasi, satu yang aktif dalam satu waktu; mengaktifkan satu membuat URL otorisasinya sendiri.
  • state: nilai opsional yang dikembalikan TikTok pada redirect, yang disarankan sebagai penjaga terhadap CSRF.
  • disable_auto_auth=1: menampilkan halaman tinjauan kepada pemilik yang sebelumnya telah menyetujui izin yang sama, yang jika tidak akan langsung dialihkan TikTok.

Bagaimana Anda menukar kode menjadi token?

Dengan POST ke /tt_user/oauth2/token/ dari server Anda, dalam format JSON. client_id dan client_secret adalah App ID dan Secret yang ditampilkan di My Apps, App Detail, Basic Information; grant_type adalah authorization_code; auth_code adalah kode dari redirect; dan redirect_uri harus sama dengan URL redirect pemilik akun TikTok yang diatur di aplikasi.

Exchange the authorization code
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/oauth2/token/' \
  -H 'Content-Type: application/json' \
  -d '{
    "client_id": "<APP_ID>",
    "client_secret": "<APP_SECRET>",
    "grant_type": "authorization_code",
    "auth_code": "<AUTH_CODE>",
    "redirect_uri": "https://app.example.com/tiktok/callback/"
  }'

Apa yang dikandung respons token?

Objek JSON berisi code, message, request_id dan data. Code 0 berarti penukaran berhasil, dan data memuat kedua token serta ID akun:

  • access_token: token jangka pendek untuk panggilan API, berlaku satu hari.
  • token_type: Bearer, yang oleh TikTok dijelaskan dapat digunakan oleh siapa pun yang memegang token.
  • scope: izin yang diberikan kepada token, dalam satu string dipisahkan koma.
  • expires_in: sisa detik sebelum token akses kedaluwarsa, 86400 dalam contoh TikTok.
  • refresh_token: token yang memperbarui akses, berlaku setahun; catatan TikTok adalah menyimpannya.
  • refresh_token_expires_in: sisa detik sebelum token refresh kedaluwarsa.
  • open_id: ID khusus aplikasi untuk akun TikTok.
A token response (scope shortened)
{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "access_token": "<ACCESS_TOKEN>",
    "token_type": "Bearer",
    "scope": "user.info.basic,user.info.stats,user.insights,video.list,video.insights,video.publish,comment.list,comment.list.manage",
    "expires_in": 86400,
    "refresh_token": "<REFRESH_TOKEN>",
    "refresh_token_expires_in": 31536000,
    "open_id": "<OPEN_ID>"
  }
}

Bagaimana token dikirim pada panggilan API?

Dalam header Access-Token pada endpoint Accounts API dari /business/get/ sampai /business/video/publish/, sementara akun itu sendiri disebut di business_id, diisi dengan open_id dari respons yang sama. Endpoint OAuth bekerja sebaliknya: /tt_user/oauth2/token/, /tt_user/oauth2/refresh_token/ dan /tt_user/oauth2/revoke/ menerima client_id dan client_secret aplikasi dalam isi body JSON, tanpa header Access-Token.

Bagaimana cara memperbarui token akses?

Dengan POST ke /tt_user/oauth2/refresh_token/ yang membawa client_id, client_secret, grant_type diisi refresh_token, dan refresh_token yang tersimpan. Jawabannya memiliki field yang sama dengan penukaran pertama: access_token baru beserta expires_in-nya, refresh_token untuk disimpan pada pembaruan berikutnya, dan detik yang masih tersisa. Jadwalkan pembaruan sebelum 24 jam, bukan menunggu kesalahan 40102.

Renew a TikTok account access token in Python
import os, time, requests

API = "https://business-api.tiktok.com/open_api/v1.3"

def renew(refresh_token: str) -> dict:
    r = requests.post(f"{API}/tt_user/oauth2/refresh_token/", json={
        "client_id": os.environ["TIKTOK_APP_ID"],
        "client_secret": os.environ["TIKTOK_APP_SECRET"],
        "grant_type": "refresh_token",
        "refresh_token": refresh_token,
    }, timeout=30).json()
    if r["code"] != 0:  # 40103: the refresh token expired, so the owner authorizes again
        raise RuntimeError(f"{r['code']}: {r['message']}")
    d, now = r["data"], time.time()
    return {
        "access_token": d["access_token"],
        "access_expires_at": now + d["expires_in"],
        "refresh_token": d["refresh_token"],  # keep it for the next renewal
        "refresh_expires_at": now + d["refresh_token_expires_in"],
    }

Bagaimana cara mencabut akses?

Dari aplikasi, dengan POST ke /tt_user/oauth2/revoke/ yang berisi client_id, client_secret dan access_token yang akan dicabut; berhasil mengembalikan code 0 dengan objek data kosong. Dari sisi akun, pemilik membuka aplikasi TikTok, masuk ke Settings and privacy, Security, Manage app permissions, memilih aplikasi dan memilih Remove access. Setelah otorisasi dicabut, TikTok berhenti mengirim event comment.update untuk akun tersebut.

Revoke a TikTok account access token
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/oauth2/revoke/' \
  -H 'Content-Type: application/json' \
  -d '{"client_id": "<APP_ID>", "client_secret": "<APP_SECRET>", "access_token": "<ACCESS_TOKEN>"}'

# {"code": 0, "message": "OK", "request_id": "<REQUEST_ID>", "data": {}}

Bagaimana cara memeriksa token?

Dengan POST ke /tt_user/token_info/get/, yang tidak memerlukan izin tersendiri: kirim app_id dan access_token, dan data mengembalikan app_id, scope dan creator_id. scope mencantumkan apa yang diberikan pemilik, dan creator_id adalah ID khusus aplikasi milik akun, nilai yang diambil panggilan Accounts API sebagai business_id. Referensi TikTok mengarahkan pengembang ke sini setiap kali sebuah field memerlukan cakupan yang mungkin tidak dimiliki token.

Kesalahan apa saja yang berasal dari token?

TikTok menaruhnya di field code pada respons, biasanya di bawah status HTTP 200, jadi periksa code sebelum mempercayai panggilan. Kode pengembalian yang terkait token dan penukarannya:

  • 40102: token akses sudah kedaluwarsa; perbarui lalu panggil ulang.
  • 40103: token refresh sudah kedaluwarsa; hanya otorisasi baru oleh pemilik yang menggantikannya.
  • 40104: permintaan tidak membawa token akses.
  • 40105: token akses tidak valid atau salah.
  • 40107: token refresh tidak valid atau salah, misalnya yang dikirim untuk memperbarui token Marketing API, yang tidak pernah kedaluwarsa.
  • 40110: kode otorisasi dibatalkan, sudah dipakai atau sudah kedaluwarsa.
  • 40131: kesalahan autentikasi di dua endpoint token, akibat App ID atau secret yang salah, kode kedaluwarsa, atau refresh token yang tidak valid atau kedaluwarsa.

Apa yang diperbarui easyCoexistence untuk Anda?

Semuanya setelah proses masuk. easyCoexistence menukar kode begitu TikTok mengarahkan kembali, menyimpan kedua token terenkripsi, dan memperbarui token akses sendiri: sebelum panggilan saat tersisa kurang dari 15 menit, dan selama pemeriksaan yang dijalankan pada setiap akun sekitar setiap 6 jam saat tersisa kurang dari 8 jam. Setiap pembaruan menyimpan refresh token baru dan masa berlakunya, dan panggilan yang datang bersamaan berbagi satu pembaruan.

  • Token ditolak: saat TikTok menjawab 40102, 40104 atau 40105, koneksi ditandai untuk dihubungkan ulang dan pemilik menerima email; pengguna Partner API juga menerima channel.disconnected.
  • Kode Anda sendiri: get_social_credentials, atau GET /channels/{id}?credentials=1 pada Partner API, mengembalikan token saat ini beserta token_expires_at, jadi ambil per tugas.
  • Penghapusan: menghapus koneksi di dashboard, atau dengan DELETE /channels/{id}, mencabut token di TikTok melalui /tt_user/oauth2/revoke/.

Kesalahan umum

  • Menukar kode otorisasi di browser. Penukaran mengirim client_secret aplikasi, jadi lakukan dari server Anda, dalam 10 menit setelah redirect.
  • Membaca expires_in sebagai tanggal. Nilainya adalah sisa detik, jadi tambahkan ke waktu respons untuk mengetahui kapan token kedaluwarsa.
  • Mencabut dengan refresh token. /tt_user/oauth2/revoke/ menerima access_token, bersama client_id dan client_secret aplikasi.
  • Menganggap layar persetujuan yang hilang sebagai kegagalan. TikTok melewati halaman tinjauan untuk izin yang sudah disetujui pemilik sebelumnya; tambahkan disable_auto_auth=1 untuk menampilkannya lagi.
Melakukan ini dengan EasyCoexistence

US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring penambahan koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Berapa lama token akses TikTok API untuk Bisnis berlaku?

24 jam. Setiap respons token memberikan sisa detik di expires_in, dan token refresh, yang berlaku setahun, memperbaruinya.

Apakah endpoint refresh TikTok memerlukan redirect_uri?

Tabel parameternya mencantumkan client_id, client_secret, grant_type dan refresh_token, tanpa redirect_uri, meskipun panduan autentikasi TikTok menyebut endpoint token-nya memerlukan redirect_uri.

Apakah mencabut token TikTok menghentikan webhook-nya?

Ya. TikTok tidak lagi mengirim event comment.update ke aplikasi untuk akun tersebut sampai pemilik mengotorisasi aplikasi lagi.

Dari mana business_id TikTok berasal?

Dari open_id pada respons token, yang dipakai panggilan Accounts API sebagai business_id. /tt_user/token_info/get/ mengembalikan ID yang sama sebagai creator_id.

Lanjut membaca

Hubungkan saluran pertama Anda dalam dua menit.

Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.

  • Gratis 3 hari
  • Batalkan kapan saja
  • Hanya API resmi
  • Dipantau 24/7

Diverifikasi pada