Outdated Drivers Are Slowing You Down
One free scan finds every outdated or missing driver and matches the right update for your exact hardware.Free scan · exact hardware matchPC Slower Than It Used to Be?
A free scan shows the junk files, broken settings and background clutter dragging Windows down - then fixes them in one click.Free scan · Windows 10 & 11A Horizon API permite consultar dados da rede Stellar por HTTP, incluindo contas, saldos, transações e ativos. Abaixo estão exemplos em Python e JavaScript para fazer essas leituras e percorrer resultados paginados. Eles servem para entender os endpoints e manter código existente: a documentação da Stellar informa que Horizon está perto do fim de vida e será eventualmente descontinuada em favor de Stellar RPC e Portfolio APIs.
O que é a Horizon API
Horizon é uma interface HTTP para consultar recursos da rede Stellar, como contas, ativos, operações e transações. Suas respostas são JSON estruturado no formato HAL, não JSON:API. Em respostas de coleções, _embedded.records contém os registros; _links oferece links relacionados e de navegação.
Os exemplos a seguir fazem requisições HTTP diretas. Defina HORIZON_URL como o endereço-base da instância que você escolheu e ACCOUNT_ID como o identificador da conta que deseja consultar. Não há um endereço único adequado para todos os casos: instâncias próprias e provedores podem diferir em disponibilidade, limites e retenção.
Consultar uma conta e seus saldos
O endpoint /accounts/{account_id} retorna os dados da conta. A resposta inclui uma coleção balances; cada item descreve um saldo, que pode corresponder ao ativo nativo ou a um ativo emitido.
#1 Best Overall
Python
import os
import requests
horizon_url = os.environ["HORIZON_URL"].rstrip("/")
account_id = os.environ["ACCOUNT_ID"]
response = requests.get(
f"{horizon_url}/accounts/{account_id}",
timeout=20,
)
response.raise_for_status()
account = response.json()
print("Conta:", account["account_id"])
for balance in account.get("balances", []):
print(balance)JavaScript
const horizonUrl = process.env.HORIZON_URL.replace(//$/, "");
const accountId = process.env.ACCOUNT_ID;
const response = await fetch(
`${horizonUrl}/accounts/${encodeURIComponent(accountId)}`
);
if (!response.ok) {
throw new Error(`Horizon respondeu HTTP ${response.status}`);
}
const account = await response.json();
console.log("Conta:", account.account_id);
for (const balance of account.balances ?? []) {
console.log(balance);
}Esses trechos ilustram o formato da chamada HTTP e o acesso à resposta; não são uma validação de versões específicas do SDK Stellar. Se optar por usar stellar-sdk, confira os imports e as assinaturas correspondentes à versão instalada antes de integrar o código.
Consultar transações, operações e ativos
Horizon disponibiliza recursos para transações e ativos, além dos dados de conta. Para consultar uma transação pelo hash, construa a requisição com o endpoint de transação documentado pela instância e passe o hash como segmento de caminho. Para pesquisar ativos, use o endpoint de ativos com os parâmetros de consulta compatíveis com a pesquisa desejada. Em ambos os casos, trate a resposta como JSON e verifique o status HTTP antes de usar os campos.
As coleções podem retornar vários registros. Não presuma que uma única resposta contém todos os resultados: use os links HAL e os cursores de paginação para avançar. A forma concreta dos parâmetros de pesquisa e dos campos retornados depende do endpoint consultado; consulte a referência atual do endpoint ao adaptar essas chamadas.
Percorrer páginas de resultados
Nas coleções, Horizon aceita cursor, order (asc ou desc) e limit. O cursor deriva do paging_token de um registro. A documentação da Stellar estabelece um limite de 1 a 200 registros por página e um padrão de 10. Aumentar limit não elimina a paginação nem garante que todo o histórico venha numa chamada.
- Faça a consulta inicial da coleção com o limite e a ordenação adequados ao seu caso.
- Leia os registros em
_embedded.recordse processe-os antes de avançar. - Use o link de próxima página em
_linksquando disponível; se construir a próxima consulta, use opaging_tokendo último registro como cursor. - Continue até não haver próxima página ou até alcançar o intervalo de dados necessário.
Seguir o link fornecido pela resposta reduz o risco de reconstruir incorretamente os parâmetros da consulta. Se a aplicação optar por montar a URL, preserve o filtro original e altere o cursor de forma consistente.
Receber atualizações por streaming
Em vez de repetir consultas para descobrir se há dados novos, Horizon pode manter uma conexão aberta e transmitir atualizações à medida que a rede avança. A documentação descreve streaming para recursos como ledgers, transações, operações, pagamentos, efeitos, contas, trades e order books. Isso pode ser útil para monitoramento orientado a eventos e evita chamadas de busca que não encontram novidades.
Streaming não implica uma latência garantida nem uma economia quantificada: o resultado depende da instância, da conexão e do desenho do cliente. Planeje reconexões e recuperação de estado para que a aplicação possa retomar o processamento após uma desconexão.
Limites, retenção e escolha da instância
A referência de estrutura do Horizon descreve 3.600 requisições por hora por IP como valor padrão configurável. Isso não é uma garantia do limite aplicado por toda instância pública ou provedor; confirme as condições do endpoint que sua aplicação realmente usa. Não trate um limiar genérico de requisições por minuto como regra universal.
The Tool Desk
Outbyte Driver Updater FREEScan for outdated or missing drivers - takes under a minuteDriver Scan →Outbyte PC Repair FREEClear out junk files and repair common Windows errorsFree Scan →O histórico também depende da instância. A documentação da Stellar Development Foundation registra que, em 1º de agosto de 2024, os dados históricos do Horizon público operado pela SDF foram truncados para um ano. Uma consulta bem-sucedida, portanto, não significa que a instância ofereça todo o histórico da rede. Se o caso de uso exige uma janela maior, verifique a política de retenção do provedor ou avalie operar uma instância adequada.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Horizon, Stellar RPC e alternativas de dados
A Stellar Developers descreve Horizon como perto do fim de vida: ele continuará recebendo atualizações de compatibilidade necessárias para acompanhar mudanças futuras do protocolo, mas não novos recursos. A documentação aponta Stellar RPC e Portfolio APIs como alternativas a considerar. A escolha depende dos dados e do comportamento de que a aplicação precisa.
| Aspecto | Horizon | Stellar RPC e outras APIs de dados |
|---|---|---|
| Interface | API HTTP com endpoints de estilo REST e respostas JSON HAL. | Stellar RPC usa JSON-RPC; Portfolio APIs são também indicadas pela documentação como alternativas, mas não se deve presumir que compartilhem a mesma interface. |
| Compatibilidade de recursos | Oferece recursos de contas, transações, ativos, operações e outros dados. | Há mapeamentos de endpoints Horizon para métodos RPC, mas alguns recursos Horizon não têm substituição direta. |
| Histórico e retenção | A retenção varia por instância; o Horizon público SDF truncou dados históricos para um ano em 1º de agosto de 2024. | Confirme a retenção do produto ou provedor escolhido; não presuma que a migração preserve a mesma janela histórica. |
| Streaming | Oferece streaming para vários recursos documentados. | Verifique se a API escolhida atende à necessidade de atualização contínua; não presuma equivalência funcional. |
Antes de migrar, liste os endpoints efetivamente usados, os dados históricos exigidos e a necessidade de streaming. Para analytics ou consultas históricas sem substituição direta, pode ser necessário um indexador ou outro produto de dados. Migrar não é apenas trocar o endereço-base: formatos, métodos disponíveis e política de retenção também importam.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
Quick wins for a faster PC:
Repair Windows errors before they cause bigger problemsFix Now →Scan for outdated or missing drivers - takes under a minuteDriver Scan →Clear out junk files and repair common Windows errorsFree Scan →
