查询账户

API文档最后更新: 2026-08-31

5. 账户

5.1 查询账户

请求方式：GET
请求地址：/account

请求字段：无。

返回字段：

字段	JSON 类型	必填	含义
`code`	integer	是	固定为 `0`，表示请求成功
`message`	string	是	本次请求的处理说明
`data`	object	是	当前采购账户资料
`data.accountRef`	integer	是	当前采购会员用户 ID，与请求头 `X-Kys-User-Id` 一致
`data.availableAmount`	number	是	当前可用余额，单位为人民币元，最多保留两位小数
`data.accessState`	string	是	`enabled` 表示可正常调用；`suspended` 表示账户已暂停，除本接口外的其他接口都会返回 `CREDENTIAL_SUSPENDED`
`requestId`	string	是	本次请求编号，排查问题时提供给平台

返回当前账户编号、可用余额和使用状态：

{
  "code": 0,
  "message": "success",
  "data": {
    "accountRef": 1000,
    "availableAmount": 5023.00,
    "accessState": "enabled"
  },
  "requestId": "req_01K0EXAMPLE"
}

账户暂停后仍可调用本接口查看余额和状态，但不能继续查询商品、下单或操作订单和售后。