Ligue as suas ferramentas
e o seu assistente de IA

Tres passos, cerca de cinco minutos. Incluido em todos os planos, tambem no periodo experimental.

Os exemplos de codigo abaixo estao em ingles.

  1. Crie uma chave

    Inicie sessao e abra as Definicoes, separador API. Escolha se a chave pode apenas ler os seus dados ou tambem altera-los, e guarde-a num local seguro. E mostrada uma unica vez.

  2. Aponte o seu software para o endereco

    Envie a chave num cabecalho Authorization em cada pedido. Comece pelo primeiro exemplo abaixo, que confirma que a chave funciona e indica a que conta pertence.

    curl https://hostearnings.com/api/v1/me \
      -H "Authorization: Bearer YOUR_KEY"
    
    # then, for example
    curl "https://hostearnings.com/api/v1/transactions?start=2026-01-01&end=2026-03-31&limit=50" \
      -H "Authorization: Bearer YOUR_KEY"
    
    curl "https://hostearnings.com/api/v1/reports?type=net_cash_flow&start=2026-01-01&end=2026-03-31" \
      -H "Authorization: Bearer YOUR_KEY"
  3. Ou ligue um assistente de IA

    Assistentes como o Claude podem falar com a sua conta atraves do endereco abaixo, usando uma norma aberta chamada MCP. Depois de ligado, pode perguntar pelos seus numeros e entregar um ficheiro de pagamentos em linguagem comum.

    claude mcp add --transport http hostearnings https://hostearnings.com/mcp \
      --header "Authorization: Bearer YOUR_KEY"

O que uma chave pode e nao pode fazer

Uma chave apenas de leitura nunca pode alterar os seus registos. As chaves expiram ao fim de noventa dias salvo indicacao em contrario, e pode revogar uma a qualquer momento, com efeito no pedido seguinte. Nenhuma chave pode criar outra chave, alterar a sua faturacao nem publicar seja o que for. O que e eliminado vai para a reciclagem, de onde pode ser restaurado.

Utilizacao razoavel

Sessenta pedidos por minuto e cinco mil por dia por chave, com limites mais apertados em importacoes e relatorios. A sua propria utilizacao da aplicacao e contada em separado, por isso um assistente a trabalhar em segundo plano nao pode esgotar as suas exportacoes.

Criar uma chave

Tera de ter sessao iniciada.