移動

• リクエスト
• レスポンス
• 例

新規トランザクションIDおよびnonceの取得

get

/restproxy/api/v2/channels/{channelName}/transaction-id

チャネル名および登録によって非同期モードのトランザクションIDとnonceをリクエストします。トランザクションは、後で非同期モードで呼び出されます。

リクエスト

サポートされるメディア・タイプ

• application/json

パス・パラメータ

• channelName(必須): string
  チャネルのID

問合せパラメータ

• role: string
  使用するHyperledger Fabric登録の名前

先頭に戻る

レスポンス

サポートされるメディア・タイプ

• application/json

200レスポンス

操作の成功

本文()

ルート・スキーマ: schema

型: object

ソースの表示

• error: string
• result: object result
• returnCode(必須): string
  許容値: [ "Success", "Failure" ]

{
    "type":"object",
    "required":[
        "returnCode"
    ],
    "properties":{
        "returnCode":{
            "$ref":"#/definitions/returnCode"
        },
        "error":{
            "type":"string"
        },
        "result":{
            "type":"object",
            "required":[
                "txid"
            ],
            "properties":{
                "txid":{
                    "description":"Transaction ID",
                    "type":"string"
                },
                "nonce":{
                    "description":"Nonce value",
                    "type":"string"
                }
            }
        }
    }
}

ネストしたスキーマ: result

型: object

ソースの表示

• nonce: string
  nonce値
• txid(必須): string
  トランザクションID

{
    "type":"object",
    "required":[
        "txid"
    ],
    "properties":{
        "txid":{
            "description":"Transaction ID",
            "type":"string"
        },
        "nonce":{
            "description":"Nonce value",
            "type":"string"
        }
    }
}

400レスポンス

不正なリクエスト

401レスポンス

未認可

403レスポンス

禁止されています

404レスポンス

無効なパラメータ

500レスポンス

サービス使用不可

先頭に戻る

例

このエンドポイントは、チャネルIDと登録によって非同期モードのトランザクションIDとnonceを生成するために使用されます。トランザクションは、後で非同期モードで呼び出されます。Nonceは、非同期トランザクションで1回のみ使用できるランダムに生成された番号です。その名前は、1回(once)のみ使用される番号(n)に由来しています。

次の例は、cURLを使用してRESTリソースにGETリクエストを発行し、新しい非同期トランザクションIDおよびnonceを取得する方法を示しています。

curl -v -u <username>:<password> -X GET \
  "https://<rest proxy of your blockchain instance>/api/v2/channels/<channel_name>/transaction-id" \
  -H "accept: application/json"

たとえば、

curl -v -u <username>:<password> -X GET \
  "https://myvm.oracle.com:10001/restproxy/api/v2/channels/default/transaction-id" \
  -H "accept: application/json"

ノート:

ブロックチェーン・インスタンスのRESTプロキシ値は、インスタンス・コンソールの「ノード」タブから確認できます。

レスポンス本文の例

JSON形式のレスポンス本文のコンテンツの例を次に示します。レスポンスで生成されるトランザクションIDとnonceを使用して、後で非同期トランザクションを実行できます。

{
    "returnCode": "Success",
    "error": "",
    "result": {
        "txid": "afb7ebae607927a7d80caafd203e380443212045cb1f60ad26ce2bddd48fb7d9",
        "nonce": "bb8367a8ebf34eef53aa0e2eaca9039c1cb0b6f3a6c840ac"
    }
}

先頭に戻る