Crie uma chave
- No app Money Tracker, abra Perfil e escolha Chaves de API.
- Toque em Criar chave, dê um nome e marque o que ela pode fazer.
- Copie a API_KEY e o API_SECRET. O segredo aparece só uma vez.
Cada conta pode ter uma chave ativa. Para trocá-la, revogue-a na mesma tela e crie uma nova. Uma chave revogada para de funcionar na hora.
Autenticação
Envie os dois valores como cabeçalhos em toda solicitação. Nunca coloque o segredo em uma URL, uma página web ou um app que outras pessoas possam abrir.
- X-Api-Key
- Sua API_KEY. Começa com mtu_.
- X-Api-Secret
- Seu API_SECRET, 40 letras e números.
curl "https://moneytracker.arizu.id/api/v1/transactions?month=2026-11&type=income" \
-H "X-Api-Key: mtu_YOUR_API_KEY" \
-H "X-Api-Secret: YOUR_API_SECRET"Permissões
Uma chave só recebe as permissões que você marcar. Uma permissão de escrita inclui a de leitura.
- transactions:read
- Ler transações
- transactions:write
- Registrar, alterar e excluir transações
- categories:read
- Ler categorias
- categories:write
- Adicionar e excluir categorias
- money_sources:read
- Ler fontes de dinheiro e seus saldos
- money_sources:write
- Adicionar, alterar e excluir fontes de dinheiro
- profile:read
- Ler o nome, o e-mail, a moeda, o idioma e o plano da conta
Endpoints
Os caminhos são relativos à URL base. Os valores ficam na moeda da conta.
Conta
-
GET
/api/v1/auth/meprofile:readO perfil da conta.
Transações
-
GET
/api/v1/transactionstransactions:readTransações, das mais recentes para as mais antigas. Filtros: month (2026-11), type (income ou expense), source_id, page, per_page (até 100).
-
GET
/api/v1/transactions/{id}transactions:readUma transação.
-
POST
/api/v1/transactionstransactions:writeRegistra uma transação. Obrigatórios: type, amount, occurred_on (2026-11-02). Opcionais: category_id, payment_source_id, note (até 255 caracteres), client_ref.
-
PUT
/api/v1/transactions/{id}transactions:writeAltera uma transação. Envie os mesmos campos usados ao registrar, sem client_ref.
-
DELETE
/api/v1/transactions/{id}transactions:writeExclui uma transação.
Categorias
-
GET
/api/v1/categoriescategories:readCategorias de receitas e despesas.
-
POST
/api/v1/categoriescategories:writeAdiciona uma categoria. Obrigatórios: type, name. Opcionais: icon, color (#RRGGBB), client_ref.
-
DELETE
/api/v1/categories/{id}categories:writeExclui uma categoria.
Fontes de dinheiro
-
GET
/api/v1/payment-sourcesmoney_sources:readFontes de dinheiro com seus saldos.
-
POST
/api/v1/payment-sourcesmoney_sources:writeAdiciona uma fonte de dinheiro. Obrigatórios: type (bank, card, ewallet ou cash), holder_name. Opcionais: bank_name, provider_name, card_type, card_last4, opening_balance, client_ref.
-
PUT
/api/v1/payment-sources/{id}money_sources:writeAltera uma fonte de dinheiro.
-
DELETE
/api/v1/payment-sources/{id}money_sources:writeExclui uma fonte de dinheiro.
Qualquer outro caminho responde 403 a uma chave de API, mesmo que o próprio app o use.
Exemplo: registrar uma venda
Um ponto de venda pode registrar cada venda como receita. Dê a cada venda o próprio client_ref, para que uma nova tentativa após um erro de rede não registre a venda duas vezes.
curl -X POST "https://moneytracker.arizu.id/api/v1/transactions" \
-H "X-Api-Key: mtu_YOUR_API_KEY" \
-H "X-Api-Secret: YOUR_API_SECRET" \
-H "Content-Type: application/json" \
-d '{
"type": "income",
"amount": 125000,
"occurred_on": "2026-11-02",
"note": "Sale 1042",
"client_ref": "pos-sale-1042"
}'A resposta tem status 201 e o id da nova transação em data.id.
{
"data": {
"id": 58213,
"amount": "125000.00",
"currency": "IDR",
"original_amount": null,
"original_currency": null,
"fx_rate": null,
"fx_date": null
}
}client_ref tem de 8 a 64 letras, números ou hifens. Se a conta já tiver uma transação com o mesmo client_ref, a API devolve essa transação em vez de registrar uma nova.
Respostas e erros
Uma resposta bem-sucedida coloca o resultado em data. Uma resposta com falha traz uma mensagem em error, no idioma da conta, e muitas vezes um code que é igual em todos os idiomas.
{
"error": "This API key does not have the permission for this request",
"code": "api_key_scope_missing",
"scope": "transactions:write"
}- 401
- A chave ou o segredo está faltando ou errado, ou a chave foi revogada ou expirou.
- 403
- A chave não tem permissão para esta solicitação, o caminho está fechado para chaves de API ou a conta está bloqueada.
- 404
- O item não existe nesta conta.
- 422
- Um campo está faltando ou é inválido. Quando há fields, ele lista o que corrigir.
- 429
- Solicitações demais. Espere os segundos indicados no cabeçalho Retry-After.
Limites
Cada chave pode fazer até 60 solicitações por minuto. Os limites do seu plano continuam valendo, como no app. No plano Free, isso significa até 30 novas transações por dia.
Mantenha suas chaves seguras
- Guarde o segredo em um só lugar, como as configurações do seu ponto de venda, e não o compartilhe por chat nem por e-mail.
- Marque só as permissões de que o sistema precisa.
- Se um segredo vazar, revogue a chave no app e crie uma nova.
- O app mostra quando sua chave foi usada pela última vez. Se isso não bater com seus próprios sistemas, revogue a chave.
Dúvidas sobre a API? Escreva para ariefzufar@arizu.id / arizu.team@gmail.com.