mirror of
https://github.com/XRPLF/xrpl-dev-portal.git
synced 2025-11-11 07:15:49 +00:00
7645140477
For better URLs, the content folder has been renamed 'docs' and all other files have been moved up a level. Also, non-docs images have been moved to the static folder at the top level where they belong. Many relative paths had to be fixed to make this work.
1.4 KiB
1.4 KiB
html, parent, seo, labels
| html | parent | seo | labels | |||
|---|---|---|---|---|---|---|
| ping.html | utility-methods.html |
|
|
ping
The ping command returns an acknowledgement, so that clients can test the connection status and latency.
Request Format
An example of the request format:
{% tabs %}
{% tab label="WebSocket" %}
{
"id": 1,
"command": "ping"
}
{% /tab %}
{% tab label="JSON-RPC" %}
{
"method": "ping",
"params": [
{}
]
}
{% /tab %}
{% tab label="Commandline" %}
#Syntax: ping
rippled ping
{% /tab %}
{% /tabs %}
The request includes no parameters.
Response Format
An example of a successful response:
{% tabs %}
{% tab label="WebSocket" %}
{
"id": 1,
"result": {},
"status": "success",
"type": "response"
}
{% /tab %}
{% tab label="JSON-RPC" %}
200 OK
{
"result": {
"status": "success"
}
}
{% /tab %}
{% /tabs %}
The response follows the [standard format][], with a successful result containing no fields. The client can measure the round-trip time from request to response as latency.
Possible Errors
- Any of the [universal error types][].
{% raw-partial file="/docs/_snippets/common-links.md" /%}