# Formato de resposta comum

Todas as respostas da API MoreLogin seguem um formato JSON padrão.

## Estrutura de Resposta

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

| Campo | Tipo | Descrição |
|  --- | --- | --- |
| `code` | `integer` | Código de resultado. `0` = sucesso, outros valores indicam erros |
| `msg` | `string| nulo` | Mensagem de erro. `null` quando bem-sucedido |
| `data` | `objeto | matriz | nulo` | Carga útil de resposta. A estrutura varia de acordo com o endpoint |
| `requestId` | `string` | Identificador de solicitação exclusivo. Inclua isso ao entrar em contato com o suporte |


## Resposta de sucesso

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

## Resposta de erro

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

## Respostas paginadas

Os endpoints da lista retornam dados paginados neste formato:

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

| Campo | Descrição |
|  --- | --- |
| `total` | Número total de registros |
| `current` | Número da página atual |
| `pages` | Número total de páginas |
| `dataList` | Matriz de registros para a página atual |


## Códigos de status HTTP

| Estado | Descrição |
|  --- | --- |
| `200` | Solicitação processada com sucesso (verifique o campo `code` para ver o resultado comercial) |
| `401` | Não autorizado – token de acesso inválido ou expirado |
| `403` | Proibido – permissões insuficientes |
| `429` | Muitas solicitações — limite de taxa excedido |
| `500` | Erro interno do servidor – entre em contato com o suporte |


> **Dica**: sempre verifique o campo `code` no corpo da resposta, não apenas o código de status HTTP. Um status HTTP `200` com `code: 99001` significa que a solicitação foi recebida, mas falhou na validação.