API para desenvolvedores

Leia e registre transações, categorias e fontes de dinheiro da sua própria conta do Money Tracker a partir de outro sistema, como um ponto de venda ou um script. Uma chave só acessa os dados da conta que a criou.

URL base
https://moneytracker.arizu.id
Autenticação
X-Api-Key
X-Api-Secret
Formato
JSON via HTTPS
Limites
60 solicitações por minuto por chave

Crie uma chave

  1. No app Money Tracker, abra Perfil e escolha Chaves de API.
  2. Toque em Criar chave, dê um nome e marque o que ela pode fazer.
  3. 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.
Solicitação
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:read

    O perfil da conta.

Transações

  • GET/api/v1/transactionstransactions:read

    Transaçõ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:read

    Uma transação.

  • POST/api/v1/transactionstransactions:write

    Registra 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:write

    Altera uma transação. Envie os mesmos campos usados ao registrar, sem client_ref.

  • DELETE/api/v1/transactions/{id}transactions:write

    Exclui uma transação.

Categorias

  • GET/api/v1/categoriescategories:read

    Categorias de receitas e despesas.

  • POST/api/v1/categoriescategories:write

    Adiciona uma categoria. Obrigatórios: type, name. Opcionais: icon, color (#RRGGBB), client_ref.

  • DELETE/api/v1/categories/{id}categories:write

    Exclui uma categoria.

Fontes de dinheiro

  • GET/api/v1/payment-sourcesmoney_sources:read

    Fontes de dinheiro com seus saldos.

  • POST/api/v1/payment-sourcesmoney_sources:write

    Adiciona 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:write

    Altera uma fonte de dinheiro.

  • DELETE/api/v1/payment-sources/{id}money_sources:write

    Exclui 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.

Solicitação
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.

Resposta 201
{
  "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.

Resposta 403
{
  "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.