Blockchain Auth API

身份驗證 API 發出使用 Hive 區塊鏈 API 和區塊鏈開放 API 所需的身份驗證令牌。

問題認證令牌¶

此 API 發出使用區塊鏈服務 API 所需的身份驗證令牌。

請求網址¶

實時 URL	https://bc-platform-auth.withhive.com/v2/auth-token
沙盒 URL	https://sandbox-bc-platform-auth.withhive.com/v2/auth-token
HTTP 方法	POST
內容類型	application/json

請求主體¶

欄位名稱	描述	類型	是否必填
id	用於發放身份驗證令牌的 ID 值	字串	是
secretKey	使用 API 所需的密鑰	字串	是

回應¶

欄位名稱	描述	類型
code	API 請求結果代碼，0: 成功	數字
message	結果訊息	字串
data	API 回應	json
data.accessToken	使用 API 所需的身份驗證令牌	字串
data.refreshToken	當舊的 accessToken 過期時，用於發出新的 accessToken 的令牌	字串

請求範例¶

curl -X 'POST' 
  'https://sandbox-bc-platform-auth.withhive.com/v2/auth-token' 
  -H 'accept: */*' 
  -H 'Content-Type: application/json' 
  -d '{
  "id": "test",
  "secretKey": "1234"
}'

回應範例¶

{
  "code": 0,
  "message": "success",
  "data": {
    "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImNvbS5jb20ydXMuYzJ4d2FsbGV0Lmdsb2JhbC5ub3JtYWwiLCJyb2xlIjoib3BlcmF0b3IiLCJhZGRyZXNzIjoieHBsYTE5cHdkYTJsdXQ5eGFlZnI4Z3NtZ2t0dXFldzkwc2M1YWpseGhrZyIsImlhdCI6MTY2NzM4MjY5NSwiZXhwIjoxNjY3NDY5MDk1fQ.xRq3ew5GAcn0zEcTEyRAXByjAbhgRQb3aWqaxy_iQ68",
    "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImNvbS5jb20ydXMuYzJ4d2FsbGV0Lmdsb2JhbC5ub3JtYWwiLCJyb2xlIjoib3BlcmF0b3IiLCJhZGRyZXNzIjoieHBsYTE5cHdkYTJsdXQ5eGFlZnI4Z3NtZ2t0dXFldzkwc2M1YWpseGhrZyIsImlhdCI6MTY2NzM4MjY5NSwiZXhwIjoxNjY3OTg3NDk1fQ.s8dL3tCwdbHUTQnWqAWbDSaGumKF3Jc_aYXVJUp1VxQ"
  }
}

重新發行驗證令牌¶

這是一個API，使用先前身份驗證令牌發出的刷新令牌來發出新的身份驗證令牌，該令牌在先前身份驗證令牌過期時需要用於使用區塊鏈服務API（區塊鏈開放API，Hive 區塊鏈API）。

請求 URL¶

直播網址	https://bc-platform-auth.withhive.com/v2/refresh-token
沙盒網址	https://sandbox-bc-platform-auth.withhive.com/v2/refresh-token
HTTP 方法	POST
內容類型	application/json

請求標頭¶

欄位名稱	描述	類型	必需
授權	調用 API 時需要 refreshToken	字串	Y

請求主體¶

沒有請求主體。

回應¶

欄位名稱	描述	類型
code	API 請求結果代碼，0：成功	數字
message	結果消息	字串
data	API 回應	json
data.accessToken	使用 API 所需的身份驗證令牌	字串
data.refreshToken	當舊的 accessToken 過期時，用於發出新的 accessToken 的令牌	字串

請求範例¶

  curl -X 'POST' 
  'https://test-bc-platform-auth.withhive.com/v2/refresh-token' 
  -H 'accept: */*' 
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXlObyI6MSwiaWQiO...' 
  -d ''

回應範例¶

{
  "code": 1000,
  "message": "success",
  "data": {
    "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImNvbS5jb20ydXMuYzJ4d2FsbGV0Lmdsb2JhbC5ub3JtYWwiLCJyb2xlIjoib3BlcmF0b3IiLCJhZGRyZXNzIjoieHBsYTE5cHdkYTJsdXQ5eGFlZnI4Z3NtZ2t0dXFldzkwc2M1YWpseGhrZyIsImlhdCI6MTY2NzQ3MTIwMSwiZXhwIjoxNjY3NTU3NjAxfQ.icFnROeEU7RI0FvEdPR5Oa26YqEihwcBN-KT_n_iq_o",
    "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImNvbS5jb20ydXMuYzJ4d2FsbGV0Lmdsb2JhbC5ub3JtYWwiLCJyb2xlIjoib3BlcmF0b3IiLCJhZGRyZXNzIjoieHBsYTE5cHdkYTJsdXQ5eGFlZnI4Z3NtZ2t0dXFldzkwc2M1YWpseGhrZyIsImlhdCI6MTY2NzQ3MTIwMSwiZXhwIjoxNjY4MDc2MDAxfQ.fclh8qVxLRG0Z1Fn2KRtW7Dmm6KFY5H4jvRSroy-mag"
  }
}