Blockchain Serviceの概要

Prev Next

VPC環境で利用できます。

Blockchain Serviceは、Hyperledger Fabricを利用して、プライベートやコンソーシアム型のブロックチェーンネットワークを構築できる NAVERクラウドプラットフォームのサービスです。Blockchain Serviceでは、ブロックチェーンネットワークの構成要素情報に関する APIを RESTful形式で提供します。

Blockchain Serviceの共通設定

Blockchain Service APIで共通して使用されるリクエスト形式とレスポンス形式を説明します。

リクエスト

共通リクエスト形式を説明します。

API URL

リクエスト API URLは次の通りです。

 韓国リージョン(KR): https://blockchainservice.apigw.ntruss.com/api/v1
 シンガポールリージョン(SGN): https://blockchainservice.apigw.ntruss.com/api/sgn-v1

リクエストヘッダ

ヘッダの説明は次の通りです。

フィールド 必須の有無 説明
x-ncp-apigw-timestamp Required 1970年1月1日00:00:00協定世界時(UTC)からの経過時間(ミリ秒)
  • API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす
  • x-ncp-iam-access-key Required NAVERクラウドプラットフォームから発行された Access Key
  • Access Keyの発行と確認: 認証キーの作成を参照
  • サブアカウントの Access Key発行と確認: サブアカウントの作成を参照
  • x-ncp-apigw-signature-v2 Required NAVERクラウドプラットフォームから発行された Access Keyとマッピングする Secret Keyと HMAC暗号化アルゴリズム(HmacSHA256)でリクエスト情報を暗号化した後、Base64でエンコードした署名
  • Secret Keyの発行と確認: 認証キーの作成を参照
  • 署名の作成: シグネチャーの作成を参照
  • Content-Type Required リクエストデータの形式

    レスポンス

    共通レスポンス形式を説明します。

    レスポンスボディ

    ボディの説明は次の通りです。

    フィールド タイプ 必須の有無 説明
    errorCode String - Blockchain Serviceレスポンスステータスコード
    message String - レスポンスステータスコードメッセージ
    status String - HTTPレスポンスステータスコード名
    resources Array - サブ権限エラー時に必要な権限リスト

    レスポンスステータスコード

    Blockchain Serviceは NAVERクラウドプラットフォームの共通レスポンスステータスコードを使用します。NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、Ncloud APIのレスポンスステータスコードをご参照ください。

    レスポンス構文

    レスポンス構文は次の通りです。

    {
      "error":
        {
          "errorCode": "string",
          "message": "string",
          "status": "string",
          "resources": []
        }
    }
    

    Blockchain Service API

    Blockchain Serviceで提供する APIの説明は次の通りです。

    API 説明
    Networkリストの照会 ブロックチェーンネットワークリストを照会
    Network情報の照会 ブロックチェーンネットワークの詳細情報を照会
    Organizationリストの照会 Organizationリストを照会
    Organization情報の照会 Organizationの詳細情報を照会
    Organization接続情報のダウンロード Organization接続情報を JSONファイルでダウンロード
    Ordererリストの照会 Ordererリストを照会
    Orderer情報の照会 Ordererの詳細情報を照会
    Orderer接続情報のダウンロード Orderer接続情報を JSONファイルでダウンロード
    Orderer Podログの照会 Orderer Podログを照会
    Orderer Pod使用量の照会 Orderer Podのリソース(CPU、Memory、Storage)使用量を照会
    Peerリストの照会 Peerリストを照会
    Peer情報の照会 Peerの詳細情報を照会
    Peer Podログの照会 Peer Podログを照会
    Peer Pod使用量の照会 Peer Podのリソース(CPU、Memory、Storage)使用量を照会
    CAリストの照会 CAリストを照会
    CA情報の照会 CAの詳細情報を照会
    CA Identityの照会 CA Identityリストと詳細情報を照会
    CA Identityのダウンロード CA Identityの証明書とキーを JSONファイルでダウンロード
    CA Podログの照会 CA Podログを照会
    CA Pod使用量の照会 CA Podのリソース(CPU、Memory、Storage)使用量を照会

    Blockchain Service関連リソース

    Blockchain Service APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。