AI Budget Assistant

API do AI Budget para desenvolvedores

O AI Budget tem uma API REST pública com autorização OAuth 2.0 – “Conectar ao AI Budget”. Com o consentimento do usuário, seu app pode ler e gravar as despesas dele e baixar recibos e categorias. O usuário escolhe o que compartilhar e pode revogar o acesso a qualquer momento.

Referência da APIRegistrar um appComo construímos

O que a API já faz hoje

Por enquanto, a API cobre despesas, recibos, categorias, receitas, orçamentos e totais de análise. Metas e outros recursos podem vir depois.

Gratuita e sem revisão

O acesso à API é gratuito. Qualquer desenvolvedor registra o próprio app no AI Budget (Configurações → Desenvolvedores) – sem revisão manual e sem espera. Os limites de requisições valem por conexão e por app.

A privacidade do usuário

O usuário decide quais contas compartilhar e pode desconectar seu app a qualquer momento em Configurações → Apps conectados (como funciona). Contas com criptografia de ponta a ponta continuam protegidas: uma conta com criptografia de texto só pode ser conectada como somente leitura, e uma conta totalmente criptografada não pode ser conectada.

Comece em 3 passos

  1. Registre um app em Configurações → Desenvolvedores: informe um nome e um redirect URI e receba um client_id e um client_secret.
  2. Envie o usuário para a URL de autorização https://app.ai-budget.pl/authorize com PKCE. O usuário entra, marca as contas e aprova as permissões.
  3. Troque o código por um token em POST /oauth/token e chame https://api.ai-budget.pl/public/v1 com o cabeçalho Authorization: Bearer ….
# 1. Send the user to the consent page (PKCE S256)
https://app.ai-budget.pl/authorize?response_type=code&client_id=aba_ci_...
  &redirect_uri=https%3A%2F%2Fexample.com%2Fcallback
  &scope=expenses%3Aread+categories%3Aread&state=...
  &code_challenge=...&code_challenge_method=S256

# 2. Exchange the code for tokens
curl -X POST https://api.ai-budget.pl/oauth/token \
  -u "$CLIENT_ID:$CLIENT_SECRET" \
  -d grant_type=authorization_code -d code="$CODE" \
  -d redirect_uri=https://example.com/callback -d code_verifier="$CODE_VERIFIER"

# 3. Call the API for one of the connected accounts
curl https://api.ai-budget.pl/public/v1/accounts -H "Authorization: Bearer $ACCESS_TOKEN"
curl https://api.ai-budget.pl/public/v1/expenses -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "X-Account-Id: $ACCOUNT_ID"

Primeira integração: eKsięgowy AI

eKsięgowy AI conecta pela API a conta da empresa e a conta pessoal de um usuário e mantém as duas estritamente separadas.

Documentação

Todos os endpoints (Swagger), com um guia passo a passo:

Referência da APIRegistrar um appComo construímos

English · Polski · Русский · Schema OpenAPI (JSON)

Usamos cookies para medir o tráfego e melhorar o site. Saiba mais