Referencia de la API de Horizon

Cómo está estructurado Horizon.

📄️ Formato de respuesta

Horizon entrega respuestas como objetos JSON formateados según HAL. El formato HAL hace que Horizon sea más explorables, paginando respuestas y conectando recursos padres e hijos. Consumir este formato es sencillo usando una de las muchas bibliotecas de código abierto disponibles para la mayoría de los lenguajes de programación principales.

📄️ Transmisión

Horizon proporciona un mecanismo de transmisión para recibir eventos en casi 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

Los límites de tasa de Horizon se aplican por dirección IP. Se puede configurar a través de la opción PERHOURRATE_LIMIT y, por defecto, se establece en 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 se codifican utilizando un protocolo estándar llamado Representación de Datos Externos (XDR).

📄️ Consistencia

Para los endpoints que sirven datos que pueden cambiar de ledger a ledger (por ejemplo, un saldo de 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 sean consistentes con ese ledger. Este mecanismo previene 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