Referencia de la API de Horizon

Cómo está estructurado Horizon.

📄️ Formato de Respuesta

Horizon entrega respuestas como objetos JSON formateados de acuerdo con HAL. El formato HAL hace que Horizon sea más explorante, pagina las respuestas y conecta recursos padre e hijo. Consumir este formato es simple usando una de las muchas bibliotecas de código abierto disponibles para la mayoría de los principales lenguajes de programación.

📄️ Transmisión

Horizon proporciona un mecanismo de transmisión para recibir eventos en tiempo real. En lugar de enviar repetidamente solicitudes a Horizon para actualizaciones por lotes, se establece una conexión entre un cliente y Horizon, con actualizaciones a una respuesta de endpoint transmitiéndose a medida que se cierran nuevos ledgers y ocurren actualizaciones.

📄️ Limitación de tasa

Límites de tasa de Horizon por dirección IP. Se puede configurar a través de la opción PERHOURRATE_LIMIT y tiene como valor predeterminado 3600 solicitudes por hora. Se recomienda que los operadores de Horizon ajusten este valor según sus capacidades infraestructurales individuales y necesidades de uso.

📄️ XDR

En la red Stellar, las transacciones están codificadas utilizando un protocolo estandarizado llamado External Data Representation (XDR).

📄️ Consistencia

Para los endpoints que sirven datos que pueden cambiar de ledger a ledger (por ejemplo, el saldo de una cuenta), Horizon incluye un encabezado HTTP Latest-Ledger en su respuesta. El valor del encabezado HTTP Latest-Ledger es el número de secuencia del último ledger conocido por Horizon en el momento en que se procesó la solicitud. Horizon garantizará que todos los datos incluidos en la respuesta son consistentes con ese ledger. Este mecanismo evita condiciones de carrera donde una solicitud se procesa en el límite de dos ledgers y asegura que la respuesta sea consistente con el ledger incluido en el encabezado HTTP Latest-Ledger.

🗃️ Paginación

1 elemento