Meu Dinheiro · API
Categorias

Uma categoria

GET
/categorias/{id}

Autenticação

accessToken
headerAuthorizationBearer <token>

Access token (mda_…) obtido em POST /auth/token. Vale 1 hora.

Parâmetros de caminho

id*integer

Corpo da resposta

A categoria.

application/json
  1. response
id*integer
nome*string
nome_completo*string

Com a categoria de cima, separada por /.

tipo*TipoCategoria
Valores"receita""despesa""transferencia"
categoria_pai_id*|

A categoria de cima; nulo na categoria de primeiro nível.

status*string

Inativa foi desligada no workspace, mas segue nos lançamentos antigos.

Valores"active""inactive"
sistema*boolean

Criada pelo Meu Dinheiro e usada por funções do app; não pode ser excluída.

curl -X GET "https://example.com/categorias/0"
{  "id": 1042,  "nome": "Delivery",  "nome_completo": "Alimentação/Delivery",  "tipo": "receita",  "categoria_pai_id": 1001,  "status": "active",  "sistema": true}

Cria uma categoria POST

Cria uma categoria ativa de receita ou despesa; com `categoria_pai_id`, uma subcategoria (um nível só, do mesmo tipo da de cima, que deve estar ativa). Transferência é do Meu Dinheiro e não se cria. As linhas do DRE e do DFC não fazem parte da API: a categoria nasce sem elas, e quem usa os demonstrativos as liga pelo app. Exige o papel **Editor** ou um papel com permissão de editar Categorias. A resposta tem o mesmo formato do `GET /categorias/{id}`.

Altera uma categoria (só os campos enviados) PATCH

Altera somente os campos enviados; `categoria_pai_id` nulo leva a categoria ao primeiro nível. Inativar a que tem subcategoria ativa, ou pôr sob outra a que tem subcategorias, é 422. Exige o papel **Editor** ou um papel com permissão de editar Categorias.