客服系統接入抖音授權登錄-在線客服接入抖音開放平臺登錄授權

1. 抖音授權

1. 簡介

抖音登錄是基於 OAuth2.0 協議標準構建的授權登錄系統。

抖音 OAuth2.0 授權登錄讓用戶安全登錄接入的第三方應用或網站，在抖音用戶授權登錄已接入抖音 OAuth2.0 的第三方應用或網站後，第三方可以獲取到用戶的接口調用憑證（access_token），通過該憑證可以實現獲取抖音用戶基本開放信息和其他已授權的相關信息等。

抖音 OAuth2.0 授權登錄目前支持授權碼模式，該模式在用戶授權之後會返回一個授權碼（code）給第三方應用，該授權碼只能使用一次，第三方可通過授權碼換取調用憑證。

2. 基本概念

名詞	描述	獲取方式
client_key（Client Key）	移動/網站應用的唯一標識。	在應用的「總覽」頁面中獲取。
client_secret（Client Secret）	移動/網站應用唯一標識對應的密鑰。	在應用的「總覽」頁面中獲取。
code	臨時調用憑證，在用戶完成授權後生成，用於獲取 access_token。	獲取方式，請參見抖音獲取授權碼。
scope	用戶授權的作用域。開放平臺幾乎每個接口都需要特定的 Scope。	在應用的「能力管理」> xx權限 >「查看詳情」中獲取。
access_token	接口調用憑證，用於需要用戶授權纔可以調用的接口。	通過獲取 access_token 獲取。
client_token	接口調用憑證，用於不需要用戶授權就可以調用的接口。	通過生成 client_token 獲取。
refresh_token	刷新令牌，用來刷新 access_token。	通過獲取 access_token 獲取。

3. 憑證

授權中，主要包含以下憑證。

憑證	說明	有效期
code	臨時調用憑證，用於獲取 access_token。	10 分鐘
access_token	接口調用憑證，用於需要用戶授權纔可以調用的接口。	15 天
client_token	接口調用憑證，用於不需要用戶授權就可以調用的接口。	2 小時
refresh_token	刷新令牌，用於刷新 access_token。	30 天

4. 授權流程

1. 抖音用戶請求登錄移動/網站應用。
2. 移動/網站應用向抖音開放平臺發起抖音用戶的授權登錄請求。
3. 抖音開放平臺向抖音用戶請求授權。
4. 抖音用戶同意抖音開放平臺的授權請求。
5. 抖音開放平臺收到抖音用戶授權確認後，調起或重定向到移動/網站應用，並且附帶授權臨時票據（code）。
6. 移動/網站應用調用抖音開放平臺提供的獲取 access_token 接口，獲取 access_token。
7. 抖音開放平臺通過響應參數將 access_token 返回給移動/網站應用。

5. 獲取 access_token

用戶授權後，即獲取到了臨時票據（code）後。

然後通過 code、client_key、client_secret，調用獲取 access_token 接口即可獲取 access_token。

• Client Key 和 Client Secret 在在應用的「總覽」頁面中獲取。
• code 的獲取方式，請參見請參見抖音獲取授權碼。

6. access_token 過期和續期

access_token 的有效期爲 15 天，refresh_token 的有效期爲 30 天。

 

• 若 access_token 未過期，刷新 refresh_token 不會改變原來的 access_token，但超時時間會更新，相當於續期。最多能再獲取 5 次新的 refresh_token，最長續期爲 15 + 30 + 30 * 5 = 195 天。
• 若 access_token 已過期，調用接口會報錯（error_code=10008 或 2190008）。可以通過刷新 access_token 接口進行刷新。刷新後重新獲得一個有效期爲 15 天的 access_token，但 refresh_token 的有效期保持不變。
• 若 refresh_token 未過期，可以通過刷新 refresh_token 獲取新的 refresh_token。
• 若 refresh_token 已過期，獲取 access_token 會報錯（error_code=10010），且不能通過刷新 refresh_token 獲取新的 refresh_token。此時需要重新引導用戶授權。

7. 查看/取消授權

用戶可以在「抖音」> 「我」> 「設置（右上角）」> 「帳號與安全」> 「授權管理」中查看或取消對應用的授權，取消授權後原有 access_token 會立即失效。

8. 客服系統

如果已經註冊賬號的，前往【菜單】【團隊設置】【抖音接入】【掃碼授權】綁定抖音賬號

 

 沒用註冊過客服賬號的，可以直接前往登錄頁，點擊【抖音登錄】掃碼直接授權登錄綁定