# Conta

> A organização, a chave usada e as caixas conectadas, numa chamada só.

Conceitos, regras e exemplos no guia: [Autenticação e chaves](https://docs.forsi.com.br/autenticacao).

**Códigos de erro comuns aqui**: `nao_autorizado`, `muitas_falhas` (todos em [Erros](https://docs.forsi.com.br/erros)).

## GET /me — Quem sou eu

- URL: `GET https://chat.forsi.com.br/api/v1/me`
- Acesso: qualquer chave válida · módulo do plano: API
- Sucesso: `200`, `{"dados": ...}` com `Eu`
- Página: https://docs.forsi.com.br/api/conta/me (Markdown: https://docs.forsi.com.br/api/conta/me.md)

A organização, a chave (escopos, validade), os limites e as caixas com o estado das conexões.

**Exemplo (curl)**

```bash
curl "https://chat.forsi.com.br/api/v1/me" \
  -H "Authorization: Bearer $FORSI_CHAVE"
```

**Resposta `200` (exemplo)**

```json
{
  "dados": {
    "organizacao": {"id":"dddecb67-6b55-43da-94f6-18c8d6680571","nome":"Maria Souza"},
    "chave": {
      "id": "71c5c606-a9d7-4270-8891-45d783aa9b71",
      "nome": "Maria Souza",
      "prefixo": "fcv2_live_EXAMPLE",
      "escopos": ["texto"],
      "expira_em": "2026-10-04T13:05:12.481Z"
    },
    "limites": {"por_minuto":300,"org_por_minuto":600,"envios_por_minuto":60,"envios_org_por_minuto":120},
    "trava_spam_meta": {"ligada":false,"horas":12},
    "caixas": [
      {
        "id": "7a9d53e9-9d1b-4122-923b-fac67958f445",
        "nome": "Maria Souza",
        "canal": "whatsapp",
        "telefone": "+5531988887777",
        "conexoes": [
          {
            "tipo": "texto",
            "estado": "texto",
            "sem_acesso_meta": {"desde":"2026-10-04T13:05:12.481Z","ultima_leitura_ok":"2026-10-04T13:05:12.481Z"},
            "restricao_meta": {}
          }
        ]
      }
    ]
  }
}
```

**Erros**: `401`, `403`, `422`, `429` (formato e códigos em "Erros"; códigos desta seção no início dela).

## Objetos das respostas

Campos de cada objeto devolvido em `dados`. Campos novos podem aparecer: ignore os que não conhecer.

### Eu

| Campo | Tipo | Obrigatório | Notas |
| --- | --- | --- | --- |
| `organizacao` | object | não |  |
| `organizacao.id` | uuid | não |  |
| `organizacao.nome` | string | não |  |
| `chave` | object | não |  |
| `chave.id` | uuid | não |  |
| `chave.nome` | string | não |  |
| `chave.prefixo` | string | não |  |
| `chave.escopos` | lista de string | não |  |
| `chave.expira_em` | data e hora ISO 8601 ou null | não |  |
| `limites` | object | não |  |
| `limites.por_minuto` | integer | não |  |
| `limites.org_por_minuto` | integer | não |  |
| `limites.envios_por_minuto` | integer | não |  |
| `limites.envios_org_por_minuto` | integer | não |  |
| `trava_spam_meta` | object | não | Trava de spam da Meta da organização (Configurações > API). |
| `trava_spam_meta.ligada` | boolean | não |  |
| `trava_spam_meta.horas` | integer | não | Duração da restrição quando a Meta não manda data. |
| `caixas` | lista de object | não |  |
| `caixas[].id` | uuid | não |  |
| `caixas[].nome` | string | não |  |
| `caixas[].canal` | string | não |  |
| `caixas[].telefone` | string ou null | não |  |
| `caixas[].conexoes` | lista de object | não |  |

---

Página: https://docs.forsi.com.br/api/conta · Índice: https://docs.forsi.com.br/llms.txt · Tudo num arquivo: https://docs.forsi.com.br/llms-full.txt