AI Budget Assistant

API do AI Budget para programadores

O AI Budget tem uma API REST pública com autorização OAuth 2.0 – «Ligar ao AI Budget». Com o consentimento do utilizador, a sua aplicação pode ler e escrever as despesas dele e obter os talões e as categorias. O utilizador escolhe o que partilha e pode revogar o acesso a qualquer momento.

Referência da APIRegistar uma aplicaçãoComo a construímos

O que a API já faz hoje

Por agora, a API abrange despesas, talões, categorias, receitas, orçamentos e totais de análise. Objetivos e outros recursos poderão chegar mais tarde.

Gratuita e sem revisão

O acesso à API é gratuito. Qualquer programador regista a aplicação no AI Budget (Definições → Programadores) – sem revisão manual nem esperas. Os limites de pedidos aplicam-se por ligação e por aplicação.

A privacidade do utilizador

É o utilizador que decide que contas partilha, e pode desligar a sua aplicação a qualquer momento em Definições → Aplicações ligadas (como funciona). As contas com encriptação ponta a ponta continuam protegidas: uma conta com encriptação de texto só pode ser ligada em modo de leitura, e uma conta totalmente encriptada não pode ser ligada.

Comece em 3 passos

  1. Registe uma aplicação em Definições → Programadores: indique um nome e um redirect URI e recebe um client_id e um client_secret.
  2. Envie o utilizador para o URL de autorização https://app.ai-budget.pl/authorize com PKCE. O utilizador inicia sessão, assinala 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 liga, através da API, a conta da empresa e a conta pessoal de um utilizador e mantém-nas estritamente separadas.

Documentação

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

Referência da APIRegistar uma aplicaçãoComo a construímos

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

Utilizamos cookies para medir o tráfego e melhorar o site. Saber mais