区块链认证 API

Auth API发放使用Hive区块链API和区块链开放API所需的身份验证令牌。

问题认证令牌¶

此 API 发放使用区块链服务 API 所需的身份验证令牌。

请求 URL¶

直播网址	https://bc-platform-auth.withhive.com/v2/auth-token
沙盒网址	https://sandbox-bc-platform-auth.withhive.com/v2/auth-token
HTTP 方法	POST
内容类型	application/json

请求体¶

字段名称	描述	类型	必需
id	用于发放身份验证令牌的 ID 值	字符串	是
secretKey	使用 API 所需的密钥	字符串	是

响应¶

字段名称	描述	类型
code	API 请求结果代码，0：成功	number
message	结果消息	string
data	API 响应	json
data.accessToken	使用 API 所需的认证令牌	string
data.refreshToken	当旧的 accessToken 过期时，用于发放新的 accessToken 的令牌	string

请求示例¶

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

请求头¶

字段名称	描述	类型	必需
Authorization	调用API时需要refreshToken	字符串	是

请求体¶

没有请求体。

响应¶

字段名称	描述	类型
code	API请求结果代码，0：成功	number
message	结果消息	string
data	API响应	json
data.accessToken	使用API所需的身份验证令牌	string
data.refreshToken	当旧的accessToken过期时，用于发放新的accessToken的令牌	string

请求示例¶

  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"
  }
}