此篇内容尚无原站英文对应版本;切换语言后可浏览英文资料库。
列举所有错误可能发生的方式几乎是不可能的。某些可能发生在运输层(例如,丢掉网络数据包),这种情况下,结果将根据你使用的客户端和运输工具而有所不同。然而,如果
streamd服务器成功收到你的请求,那它将试图以标准化的错误格式回应。
一些错误样例:
{
"id": 3,
"status": "error",
"type": "response",
"error": "ledgerIndexMalformed",
"request": {
"account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
"command": "account_info",
"id": 3,
"ledger_index": "-",
"strict": true
}
}
HTTP Status: 200 OK
{
"result": {
"error": "ledgerIndexMalformed",
"request": {
"account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
"command": "account_info",
"ledger_index": "-",
"strict": true
},
"status": "error"
}
}
{
"result": {
"error": "ledgerIndexMalformed",
"request": {
"account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
"command": "account_info",
"ledger_index": "-",
"strict": true
},
"status": "error"
}
}
WebSocket API错误响应格式
| 字段 | 类型 | 描述 |
|---|---|---|
| id | (Varies) | 在 WebSocket请求中提供此响应的ID |
| status | String | "error" 如果请求导致错误 |
| type | String | 通常 "response", 这表示对命令的成功响应 |
| error | String | 发生错误类型的唯一代码 |
| request | Object | 以JSON格式提示此错误的请求副本。警告:如果请求包含任何账户机密,将在此处展示 |
JSON-RPC API错误响应格式
一些JSON-RPC请求将在HTTP层以错误代码回应。这些情况下,这种回应是回应主体中的纯文本。例如,如果你忘记在method参数中指定命令,那回应类似于下面这样:
HTTP Status: 400 Bad Request Null method对于其他返回HTTP 状态代码200 OK的错误来说,JSON格式的回应出现在下面这些字段:
| 字段 | 类型 | 描述 |
|---|---|---|
| result | Object | 包含对查询响应的对象 |
| result.error | String | 发生错误类型的唯一代码 |
| result.status | String | "error" 如果请求导致错误 |
| result.request | Object | 以JSON格式提示此错误的请求副本。警告:如果请求包含任何账户机密,将在此处展示!注意:不管请求是什么,请求都以WebSocket格式重新格式化。 |
