リクエストのフォーマット
WebSocketフォーマット
rippled
サーバへのWebSocketを開いた後、以下の属性を使用して、コマンドをJSONオブジェクトとして送信できます。
- コマンド名を最上位の
"command"
フィールドに指定します。 - このコマンドのすべての関連パラメーターも最上位に指定します。
- オプションで、任意の値を指定した
"id"
フィールドを指定します。このリクエストへのレスポンスでは、同一の"id"
フィールドを使用します。そうすることで、レスポンスが順不同で到達した場合も、どのリクエストによってどのレスポンスを得られたのかがわかります。
レスポンスはJSONオブジェクトとして返されます。
JSON-RPCフォーマット
JSON-RPCリクエストを実行するには、rippled
サーバがJSON-RPC接続をリッスンしているポートおよびIPで、HTTP POSTリクエストをルートパス(/
)に送信します。HTTP/1.0またはHTTP/1.1を使用できます。HTTPSを使用する場合は、TLS v1.2を使用してください。セキュリティ上の理由から、rippled
ではSSL v3以前を サポートしていません 。
常にContent-Type
ヘッダー(値application/json
)を指定してください。
複数のリクエストを実行する予定の場合は、リクエスト間で接続を閉じてから開く操作を行わずに済むように、Keep-Alivesを使用してください。
以下の属性を指定したリクエスト本文をJSONオブジェクトとして送信します。
- コマンドを最上位の
"method"
フィールドに指定します。 - 最上位の
"params"
フィールドを指定します。このフィールドの内容は、コマンドのすべてのパラメーターが指定された1つの入れ子JSONオブジェクトのみを保持している1要素配列です。
レスポンスもJSONオブジェクトです。
コマンドライン形式
コマンドラインでは、通常の(ダッシュが先頭に付いた)コマンドラインオプションの後にコマンドを指定し、その後に一連の限定的なパラメーターをスペースで区切って指定します。スペースやその他の特殊文字が含まれている可能性のあるパラメーター値は、一重引用符で囲みます。
リクエストの例
- WebSocket
- JSON-RPC
- コマンドライン
{ "id": 2, "command": "account_info", "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", "strict": true, "ledger_index": "validated" }