ブロックチェーンサービス API は、ブロックチェーンサービスサーバーアドレスに HTTP リクエストを送信することで呼び出されます。リクエストには、API の説明を参照してパラメーターを設定する必要があります。呼び出し後、システムはパラメーターに応じて応答します。リクエストと応答はどちらも UTF-8 文字セットでエンコードされます。
リクエスト構文
ブロックチェーンサービスの API は RPC 形式です。HTTP POST リクエストを送信することで、ブロックチェーンサービスを呼び出すことができます。
リクエスト構文は次のとおりです。
http://Endpoint/?Action=xx&Parametersここで、
- エンドポイント: BaaS API のエンドポイントは baas.aliyuncs.com です。
- アクション: 実行される操作です。たとえば、DescribeFabricOrganization インターフェイスを呼び出して 1 つの組織の詳細を表示します。
- バージョン: API のバージョンです。BaaS API のバージョンは 2018-12-21 です。
- パラメーター: アンパサンド（&）で区切られたリクエストパラメーターです。
リクエストパラメーターは、共通パラメーターと API 固有のパラメーターで構成されます。共通パラメーターには、API バージョンや身元認証情報などの変数が含まれます。詳細については、「共通パラメーター」をご参照ください。
次の例では、DescribeFabricOrganization インターフェイスを呼び出して、作成済みのブロックチェーン組織をクエリしています。
説明 次のコードは、読みやすくするために編集されています。
https://baas.aliyuncs.com/?Action=DescribeFabricOrganization
&Format=xml
&Version=2018-12-21
&Signature=xxxx%xxxx%3D
&SignatureMethod=HMAC-SHA1
&SignatureNonce=15215528852396
&SignatureVersion=1.0
&AccessKeyId=key-test
&Timestamp=2012-06-01T12:00:00Z
…