Disponibilidad
Principios de diseño
- Acceso público de solo lectura a los datos públicos de la blockchain.
- Ninguna operación de escritura, firma o gestión de wallet.
- Ninguna exposición directa del RPC del nodo.
- Respuestas en caché y limitación de velocidad para proteger la infraestructura.
- Indisponibilidad de la API sin impacto en la consulta del sitio.
- Documentación de los esquemas, códigos de error y límites antes de la puesta en servicio.
Recursos previstos
- Estado del servicio
- Disponibilidad de la API, altura de cadena pública e información general de la red.
- Bloques
- Lista paginada de bloques y consulta de un bloque por altura o identificador público.
- Transacciones
- Consulta de una transacción pública por su identificador.
- Direcciones
- Historial público de una dirección, sin ningún dato privado del wallet.
- Red
- Información pública sobre los pares y el estado de sincronización, agregada y no sensible.
Las rutas, los formatos de respuesta, los parámetros de paginación y los límites de velocidad se fijarán en una especificación versionada publicada antes de la apertura de la API.
Integración en el sitio
El sitio está diseñado para permanecer autónomo. Cualquier integración futura pasará por una capa de acceso dedicada, del lado del servidor, con tiempo de espera, validación de respuestas y estado de indisponibilidad explícito.
- No debe mostrarse ningún dato de demostración en producción.
- Una respuesta no disponible debe producir un estado vacío claramente identificado.
- Los errores de la API no deben revelar información de infraestructura.
- El sitio nunca debe depender de la API para mostrar sus páginas estáticas.