Lista os cartões de crédito
Os cartões do workspace com limite, vencimento, fechamento, a conta que paga a fatura e os
plásticos. Inclui os inativos e os encerrados; filtre com status=active para só os que estão
em uso. Cartão oculto para a credencial não aparece.
accessTokenAuthorizationBearer <token>Access token (mda_…) obtido em POST /auth/token. Vale 1 hora.
limit?integerItens por página.
1 <= value <= 500100cursor?stringO next_cursor da página anterior. Omita na primeira página.
status?stringactive em uso; inactive desativada; closed encerrada, só histórico.
"active""inactive""closed"Uma página de cartões.
application/json- response
data*array<>next_cursor*|Cursor da próxima página; nulo na última.
curl -X GET "https://example.com/cartoes"{ "data": [ { "id": 2052, "nome": "Visa Platinum", "status": "active", "moeda": "BRL", "banco": { "codigo": "string", "nome": "string" }, "tipo_limite": "total", "limite": 5000, "limite_disponivel": 3120.5, "dia_vencimento": 5, "dias_fechamento": 7, "proximo_vencimento": "2019-08-24", "proximo_fechamento": "2019-08-24", "conta_pagamento": { "id": 0, "nome": "string" }, "plasticos": [ { "id": 0, "nome": "Ana", "tipo": "titular", "status": "active" } ] } ], "next_cursor": "string"}Altera uma conta (todos os campos) PUT
Troca todos os campos graváveis da conta; para alterar só alguns, use `PATCH`. Exige o papel **Editor** ou um papel com permissão de editar Contas. O `tipo` não muda depois de criada: `tipo` e `id` no corpo respondem 400. Nesta versão a API altera só os tipos que ela cria; `cartao_credito` (que se altera em `/cartoes`) e `aplicacao_financeira` respondem 422. Em `contas_a_pagar` a `finalidade` também é exigida. Em conta de passivo e de patrimônio líquido o saldo inicial é gravado negativo, como na criação.
Cria um cartão POST
Cria um cartão de crédito com os plásticos (um titular e os adicionais) e a fatura do mês anterior ao vencimento, já fechada com o `valor_fatura_anterior`. Exige o papel **Editor** ou um papel com permissão de editar Contas (o mesmo do app). A conta de pagamento precisa estar na moeda do cartão e ser conta corrente, dinheiro, poupança ou conta do balanço. A resposta é o cartão criado, no formato do `GET /cartoes/{id}`. O cartão também aparece em `/contas`, com `tipo` `cartao_credito`, mas só se escreve aqui.