开发文档

错误响应

此篇内容尚无原站英文对应版本;切换语言后可浏览英文资料库。
列举所有错误可能发生的方式几乎是不可能的。某些可能发生在运输层(例如,丢掉网络数据包),这种情况下,结果将根据你使用的客户端和运输工具而有所不同。然而,如果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格式重新格式化。
THE NEXT CONNECTION

下一次连接,从这里开始。

加入 Stream 社区,一起探索价值互联。

联系我们