Oracle Blockchain Platform Enterprise Edition REST API

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

get

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

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

リクエスト

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

application/json

パス・パラメータ

channelId: string

チャネルのID

問合せパラメータ

role: string

使用する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レスポンス

不正なリクエスト

ルート・スキーマ: Error

型: object

エラー情報。

ソースの表示

errors(オプション): array errors

エラーのリスト
message: string

判読可能なエラー文字列。
status: string

プログラムによる解析を目的とした、エラーを定義する短いエラー・ステータス。
warnings(オプション): array warnings

警告のリスト

{
    "description":"Error Information.",
    "required":[
        "status",
        "message"
    ],
    "properties":{
        "status":{
            "description":"A short error status that defines the error, meant for programmatic parsing.",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string.",
            "type":"string"
        },
        "errors":{
            "type":"array",
            "description":"list of errors",
            "items":{
                "type":"string"
            }
        },
        "warnings":{
            "type":"array",
            "description":"list of warnings",
            "items":{
                "type":"string"
            }
        }
    }
}

ネストしたスキーマ: errors

型: array

エラーのリスト

ソースの表示

配列: string

{
    "type":"array",
    "description":"list of errors",
    "items":{
        "type":"string"
    }
}

ネストしたスキーマ: warnings

型: array

警告のリスト

ソースの表示

配列: string

{
    "type":"array",
    "description":"list of warnings",
    "items":{
        "type":"string"
    }
}

401レスポンス

未認可

ルート・スキーマ: Error

型: object

エラー情報。

ソースの表示

errors(オプション): array errors

エラーのリスト
message: string

判読可能なエラー文字列。
status: string

プログラムによる解析を目的とした、エラーを定義する短いエラー・ステータス。
warnings(オプション): array warnings

警告のリスト

{
    "description":"Error Information.",
    "required":[
        "status",
        "message"
    ],
    "properties":{
        "status":{
            "description":"A short error status that defines the error, meant for programmatic parsing.",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string.",
            "type":"string"
        },
        "errors":{
            "type":"array",
            "description":"list of errors",
            "items":{
                "type":"string"
            }
        },
        "warnings":{
            "type":"array",
            "description":"list of warnings",
            "items":{
                "type":"string"
            }
        }
    }
}

ネストしたスキーマ: errors

型: array

エラーのリスト

ソースの表示

配列: string

{
    "type":"array",
    "description":"list of errors",
    "items":{
        "type":"string"
    }
}

ネストしたスキーマ: warnings

型: array

警告のリスト

ソースの表示

配列: string

{
    "type":"array",
    "description":"list of warnings",
    "items":{
        "type":"string"
    }
}

403レスポンス

禁止

404レスポンス

見つかりません

ルート・スキーマ: Error

型: object

エラー情報。

ソースの表示

errors(オプション): array errors

エラーのリスト
message: string

判読可能なエラー文字列。
status: string

プログラムによる解析を目的とした、エラーを定義する短いエラー・ステータス。
warnings(オプション): array warnings

警告のリスト

{
    "description":"Error Information.",
    "required":[
        "status",
        "message"
    ],
    "properties":{
        "status":{
            "description":"A short error status that defines the error, meant for programmatic parsing.",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string.",
            "type":"string"
        },
        "errors":{
            "type":"array",
            "description":"list of errors",
            "items":{
                "type":"string"
            }
        },
        "warnings":{
            "type":"array",
            "description":"list of warnings",
            "items":{
                "type":"string"
            }
        }
    }
}

ネストしたスキーマ: errors

型: array

エラーのリスト

ソースの表示

配列: string

{
    "type":"array",
    "description":"list of errors",
    "items":{
        "type":"string"
    }
}

ネストしたスキーマ: warnings

型: array

警告のリスト

ソースの表示

配列: string

{
    "type":"array",
    "description":"list of warnings",
    "items":{
        "type":"string"
    }
}

500レスポンス

内部サーバー・エラー

ルート・スキーマ: Error

型: object

エラー情報。

ソースの表示

errors(オプション): array errors

エラーのリスト
message: string

判読可能なエラー文字列。
status: string

プログラムによる解析を目的とした、エラーを定義する短いエラー・ステータス。
warnings(オプション): array warnings

警告のリスト

{
    "description":"Error Information.",
    "required":[
        "status",
        "message"
    ],
    "properties":{
        "status":{
            "description":"A short error status that defines the error, meant for programmatic parsing.",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string.",
            "type":"string"
        },
        "errors":{
            "type":"array",
            "description":"list of errors",
            "items":{
                "type":"string"
            }
        },
        "warnings":{
            "type":"array",
            "description":"list of warnings",
            "items":{
                "type":"string"
            }
        }
    }
}

ネストしたスキーマ: errors

型: array

エラーのリスト

ソースの表示

配列: string

{
    "type":"array",
    "description":"list of errors",
    "items":{
        "type":"string"
    }
}

ネストしたスキーマ: warnings

型: array

警告のリスト

ソースの表示

配列: string

{
    "type":"array",
    "description":"list of warnings",
    "items":{
        "type":"string"
    }
}

先頭に戻る

例

このエンドポイントは、チャネル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/default/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"

ノート:

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

レスポンス本文の例

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

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

先頭に戻る