Meu Dinheiro · API
Projetos

Um projeto

GET
/projetos/{id}

Projeto de outro workspace, ou inexistente, responde 404.

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

O item.

application/json
  1. response
id*integer
nome*string
cor*|

Hexadecimal #RRGGBB.

status*StatusCadastro

inactive: desativado no app, segue nos lançamentos antigos.

Valores"active""inactive"
inicio*|
Formatodate
fim*|
Formatodate
meta_receita*|

Receita prevista para o projeto inteiro; nula quando não há meta.

meta_despesa*|

Despesa prevista, positiva. O resultado previsto é meta_receita - meta_despesa.

curl -X GET "https://example.com/projetos/0"
{  "id": 512,  "nome": "Obra Centro",  "cor": "#A4C2F4",  "status": "active",  "inicio": "2026-01-15",  "fim": "2026-06-30",  "meta_receita": 120000,  "meta_despesa": 85000.5}

Cria um projeto POST

Cria um projeto ativo. Exige o papel **Editor** ou um papel com permissão de editar Projetos. A resposta tem o mesmo formato do `GET /projetos/{id}`.

Altera um projeto (só os campos enviados) PATCH

Altera somente os campos enviados; os ausentes ficam como estão, e nulo em `inicio`, `fim` ou nas metas remove o valor. Exige o papel **Editor** ou um papel com permissão de editar Projetos.