コンテンツにスキップ

ブロックチェーン認証API

Auth APIは、Hive Blockchain APIおよびBlockchain Open APIを使用するために必要な認証トークンを発行します。

課題認証トークン¶

このAPIは、ブロックチェーンサービスAPIを使用するために必要な認証トークンを発行します。

リクエストURL¶

ライブ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値	文字列	Y
secretKey	APIを使用するために必要な秘密鍵	文字列	Y

応答¶

フィールド名	説明	タイプ
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（Blockchain Open APIs、Hive Blockchain APIs）を使用するために必要な新しい認証トークンを発行するために、以前に発行されたリフレッシュトークンを使用するAPIです。

リクエストURL¶

ライブURL	https://bc-platform-auth.withhive.com/v2/refresh-token
サンドボックスURL	https://sandbox-bc-platform-auth.withhive.com/v2/refresh-token
HTTPメソッド	POST
コンテンツタイプ	application/json

リクエストヘッダー¶

フィールド名	説明	タイプ	必須
Authorization	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"
  }
}