Monte um painel de saldos

Objetivo e pré-requisitosCopiar link da seção

Mostrar os saldos correntes do Space no seu sistema. Você precisa de uma integração habilitada com balances:read, uma chave no servidor e as variáveis configuradas.

1. Confirme o SpaceCopiar link da seção

Consulte contexto e confirme spaceId e as capacidades.

2. Busque os saldosCopiar link da seção

Use o exemplo executável de saldos ou execute:

curl --fail-with-body "$RURALZAP_BASE_URL/api/v1/integration/balances" \
  -H "Authorization: Bearer $RURALZAP_API_KEY"

3. Monte a apresentaçãoCopiar link da seção

Mapeie cada item de data por id. Exiba name, currency e balance. Identifique o instante generatedAt. Use totals para totais separados por moeda.

Resultado esperadoCopiar link da seção

Um painel com carteiras ativas e saldos correntes. O total inclui carteiras retornadas mesmo quando includeInNetWorth é falso. O campo informa participação no patrimônio do produto, não ausência da carteira na resposta.

Erros comunsCopiar link da seção

401 exige revisar chave/ambiente; 403 exige escopo e acesso. Uma resposta sem carteiras é válida. Não apresente dados antigos como consulta atual quando houver erro.

Próximos passosCopiar link da seção

Experimente os dados sintéticos e confira a referência de saldos.