# 通用响应格式

所有 MoreLogin API 响应都遵循标准 JSON 格式。

## 响应结构

```json
{
  "code": 0,
  "msg": null,
  "data": {},
  "requestId": "unique-request-id"
}
```

| 领域 | 类型 | 描述 |
|  --- | --- | --- |
| `code` | `integer` | 结果代码。 `0` = 成功，其他值表示错误 |
| `msg` | `字符串| 空` | 错误消息。成功时为 `null` |
| `data` | `对象| 数组| 空` | 响应负载。结构因端点而异 |
| `requestId` | `string` | 唯一的请求标识符。联系支持人员时请包含此信息 |


## 成功响应

```json
{
  "code": 0,
  "msg": null,
  "data": {
    "id": 1234567890
  },
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
```

## 错误响应

```json
{
  "code": 99001,
  "msg": "Invalid parameters",
  "data": null,
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
```

## 分页响应

列表端点返回以下格式的分页数据：

```json
{
  "code": 0,
  "msg": null,
  "data": {
    "total": 100,
    "current": 1,
    "pages": 10,
    "dataList": [
      { ... },
      { ... }
    ]
  },
  "requestId": "..."
}
```

| 领域 | 描述 |
|  --- | --- |
| `total` | 记录总数 |
| `current` | 当前页码 |
| `pages` | 总页数 |
| `dataList` | 当前页面的记录数组 |


## HTTP 状态代码

| 状态 | 描述 |
|  --- | --- |
| `200` | 请求已成功处理（检查 `code` 字段以获取业务结果） |
| `401` | 未经授权 - 访问令牌无效或过期 |
| `403` | 禁止 — 权限不足 |
| `429` | 请求过多 — 超出速率限制 |
| `500` | 内部服务器错误 — 联系支持人员 |


> **提示**：始终检查响应正文中的 `code` 字段，而不仅仅是 HTTP 状态代码。带有 `code: 99001` 的 `200` HTTP 状态表示已收到请求但验证失败。