错误码

所有错误响应的结构都相同。请以 HTTP 状态和 error.code 为准；error.message 是便于阅读的英文文本，可能会变化。

错误格式

{
  "detail": "…",
  "error": {
    "code": "api.cursor_invalid",
    "message": "The cursor is malformed or was issued for different filters.",
    "details": {"parameter": "cursor"},
    "request_id": "01JB7Q2M4X9V3K8T5N6P0R1S2A",
    "doc_url": "https://developers.sursa.com/errors/api.cursor_invalid"
  }
}

error.code 是本页列出的错误码；error.request_id 与 X-Request-Id 头的值一致；error.doc_url 指向本页。