跳轉至

更新令牌

令牌續期 是一個使用發出的刷新令牌 (user_info.refresh_token) 來續期訪問/刷新令牌的 API，這是在進行登錄驗證和用戶信息檢索的 API 請求後進行的。

Note

訪問令牌在發出後有效期為1小時，可以在過期前或過期後使用刷新令牌進行續期。刷新令牌的有效期為30天。

請求 URL

環境 URL
生產環境 https://weblogin.withhive.com/oauth/token
沙盒環境 https://sandbox-weblogin.withhive.com/oauth/token
HTTP 方法 POST
內容類型 application/json

請求主體

字段名稱 類型 描述 必填
grant_type 字串 OAuth 2.0 授權碼流程 default: refresh_token Y
client_id 字串 在安全金鑰設置中生成的 OAuth 2.0 客戶端 ID。您可以在 Hive 控制台的 應用中心 > 安全金鑰設置 中查看。 Y
client_secret 字串 在安全金鑰設置中生成的 OAuth 2.0 客戶端密鑰。您可以在 Hive 控制台的 應用中心 > 安全金鑰設置 中查看。 Y
refresh_token 字串 刷新令牌 Y

請求主體範例

{
  "grant_type": "refresh_token",
  "client_id": "58b48cd3-df47-5b52-2627-3f9c8d01",
  "client_secret": "bec7760b237244c4c818d6174587d8e1",
  "refresh_token": "eyJraWQiOiIwYThlMThkOS1hNmZiLTM3ZDMtNjkwYy02Zjg1ZTllNCIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJpc193aGl0ZWxpc3QiOmZhbHNlLCJwcm9qZWN0X2lkIjoiY29tLmNvbTJ1cy5oaXZlc2RrIiwiZ3JhbnRfdHlwZSI6InVzZXIiLCJ1c2VyX2lkIjoyMDAwMDAxODU1MiwidG9rZW5fdHlwZSI6InJlZnJlc2hfdG9rZW4iLCJleHAiOjE3NDgxNTAzODMsImlhdCI6MTc0NTU1ODM4MywiYXV0aF92ZXIiOiJ2NCJ9.fvXTfRDYhlk21EY-ngAXbQMgYM9f-rFYPBa_GMV3JDz3cy9wwGfPTnF-VO0WkpxzpPdbG1ZX0HAdIkT4kF873ee2d-g6-JeuIEy0SFcTMpdYWXnlOfsuZlFIkzCm0OB_mlnNo_wxXHvjHM_dFDF-SfK2r9_ga8yLOXDfLJeA4XUYGwwsG3XT9x5Vy8RlUcF2aeuf-2bXdLSD2NGssZh18RTayV2CNtGuX0kj-nABVVTzLWUqbwKSrIVXjlS76zxl3SisUW_pz97iM98yLLRdpe_56_VDPzKEqVmn4bCyhhlAT1LEdu_uudlBY7hSUX0cJzcLAtj_4GReuLU9SnvQpw"
}

回應主體

欄位名稱 類型 描述 備註
code 整數 網頁登入回應代碼
access_token 字串 存取權杖 有效期：1 小時
refresh_token 字串 刷新權杖 有效期：30 天

網頁登入回應代碼

代碼 描述 備註
100 成功
1050 無效參數
2011 沒有項目資訊
2013 項目處於終止狀態
7001 沒有 OAuth2.0 客戶端 ID 值 在 Hive 控制台檢查 應用中心 > 安全金鑰設置
7002 OAuth2.0 客戶端資訊不匹配 〃
7003 沒有 OAuth2.0 客戶端資訊 〃
7004 OAuth2.0 不支持的令牌發行類型 檢查請求主體中的 grant_type
8001 創建 OAuth2.0 JWT 失敗
8002 驗證 OAuth2.0 JWT 失敗
8004 OAuth2.0 不支持的 JWT 演算法
8005 驗證 OAuth2.0 JWT Kid 失敗
8006 驗證 OAuth2.0 JWT 簽名失敗
8007 OAuth2.0 JWT 中的異常有效載荷
8008 OAuth2.0 不支持的令牌類型 只有有效載荷中的 refresh_token 可以被更新
8009 OAuth2.0 不支持的令牌範圍
8011 OAuth2.0 JWT 已過期

回應主體範例（成功）

這是當滿足以下條件時返回的回應數據的範例。

  • 令牌已成功發行。
{
  "code": 100,
  "access_token": "eyJraWQiOiIwYThlMThkOS1hNmZiLTM3ZDMtNjkwYy02Zjg1ZTllNCIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJpc193aGl0ZWxpc3QiOmZhbHNlLCJwcm9qZWN0X2lkIjoiY29tLmNvbTJ1cy5oaXZlc2RrIiwiZ3JhbnRfdHlwZSI6InVzZXIiLCJ1c2VyX2lkIjoyMDAwMDAxODU1MiwidG9rZW5fdHlwZSI6ImFjY2Vzc190b2tlbiIsImV4cCI6MTc0NTU2MTk4MywiaWF0IjoxNzQ1NTU4MzgzLCJhdXRoX3ZlciI6InY0In0.e4mCIirRpAni4A1ZEF3FDOFng3Da8hq6IqZmyyRQZsc7W3LfFi_id5TIQSDbvmagmT4GcwHztovpoYZxf8blwqES1lJmEVXsBBJ3qpEOAem0K9aVwY0zmOO3A0Eeh6Y0APABewNCpHiKPCMZwxSsMaUE56FfuYgnbhpsipR638VgyPniRVU-Bzcu0Pi2zo-5yUKbg2FCXex510fvZRxqGZPg8Rfhm-jXqAYuwALLIFf2ZykOWqVRFtczfPXwB6fLQrQvQeBnOYcHHnR1q8Fi-Rk_bQPsAffIemGvaC4vUeyx6Szzt_Gok1BsuF76lYZ5ogCn4lAlZ0SJLrgMM2-DNQ",
  "refresh_token": "eyJraWQiOiIwYThlMThkOS1hNmZiLTM3ZDMtNjkwYy02Zjg1ZTllNCIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJpc193aGl0ZWxpc3QiOmZhbHNlLCJwcm9qZWN0X2lkIjoiY29tLmNvbTJ1cy5oaXZlc2RrIiwiZ3JhbnRfdHlwZSI6InVzZXIiLCJ1c2VyX2lkIjoyMDAwMDAxODU1MiwidG9rZW5fdHlwZSI6InJlZnJlc2hfdG9rZW4iLCJleHAiOjE3NDgxNTAzODMsImlhdCI6MTc0NTU1ODM4MywiYXV0aF92ZXIiOiJ2NCJ9.fvXTfRDYhlk21EY-ngAXbQMgYM9f-rFYPBa_GMV3JDz3cy9wwGfPTnF-VO0WkpxzpPdbG1ZX0HAdIkT4kF873ee2d-g6-JeuIEy0SFcTMpdYWXnlOfsuZlFIkzCm0OB_mlnNo_wxXHvjHM_dFDF-SfK2r9_ga8yLOXDfLJeA4XUYGwwsG3XT9x5Vy8RlUcF2aeuf-2bXdLSD2NGssZh18RTayV2CNtGuX0kj-nABVVTzLWUqbwKSrIVXjlS76zxl3SisUW_pz97iM98yLLRdpe_56_VDPzKEqVmn4bCyhhlAT1LEdu_uudlBY7hSUX0cJzcLAtj_4GReuLU9SnvQpw"
}

回應主體範例 (失敗)

當滿足以下條件時，這是一個返回的響應數據示例。

  • 代幣發行失敗。
{
  "code": 1050
}