presearch

Noticias de última hora

API de acceso a los Nodos Presearch

Método GET: Estados de los nodos

https://nodes.presearch.org/api/nodes/status/:api_key


Devuelve el estado actual de todos tus nodos, así como (opcionalmente) datos agregados para esos nodos.


Notas:

*Los parámetros conectados y desconectados no se pueden establecer ambos en falso. En este caso, se utilizará el predeterminado (solo conectado).


Regístrese en Presearch, bonificación para nuevos usuarios de: regístrese en Presearch usando este enlace y obtenga 25 tokens PRE.


Parámetros de ruta

Parámetro: api_key (REQUIREDO)

Tipo: string

Descripción: Su clave personal de API de nodos (se puede encontrar en la parte inferior de la página del panel de control del nodo para cualquiera de sus nodos: https://nodes.presearch.org/dashboard



Parámetros del Query



Parámetro: api_key (REQUIREDO)

Tipo: string

Descripción: Su clave personal de API de nodos (se puede encontrar en la parte inferior de la página del panel de control del nodo para cualquiera de sus nodos: https://nodes.presearch.org/dashboard


Parámetrostart_date (OPCIONAL)

Tipo: string

Descripción: Fecha / hora UTC en formato ANSI (Y-m-d H: i): inicio del período de informe para cualquier actividad y estadísticas del nodo.

(Predeterminado: 24 horas antes de la hora actual)


Parámetro: end_date (OPCIONAL)

Tipo: string

Descripción: Fecha / hora UTC en formato ANSI (Y-m-d H: i): finalización del período de informe para cualquier actividad y estadísticas del nodo.

(Predeterminado: hora actual)


Parámetro: stats (OPCIONAL)

Tipo: boolean

Descripción: true | false: si se incluyen o no estadísticas históricas agregadas para los nodos devueltos. Las fechas entre las que se agregarán se especifican con los parámetros start_date y end_date.

(Predeterminado: false)


Parámetroconnected (OPCIONAL)

Tipoboolean

Descripción: true| false: los nodos conectados actualmente deben incluirse en la lista devuelta

(Predeterminado: true)


Parámetro: desconnected (OPCIONAL)

Tipoboolean

Descripción: true| false: los nodos desconectados actualmente deben incluirse en la lista devuelta

(Predeterminado: true)


Parámetroinclude_inactive (OPCIONAL)

Tipoboolean

Descripción: true| false: si también se incluyen los nodos que no han estado activos durante el período de tiempo especificado establecido por start_date y end_date

(Predeterminado: false)



RESPUESTA DE LA PETICIÓN

200: OK

Nodos recuperados correctamente


Notas:

* Todas las fechas se devuelven en formato zulú (UTC)

* Cada entrada en el objeto de los nodos está codificada con la clave pública de ese nodo

* El objeto de período dentro de cada objeto de nodo solo se incluye si se pasa el parámetro stats = true

* Los campos con datos no disponibles se devuelven como nulos


{

    success: true,

    start_at: "2021-01-01T00:00:00Z",

    end_at: "2021-12-31T23:59:59Z",

    nodes: {

        <node public key>: {

            meta: {

                description: "your description",

                url: "your external url",

                server_description: "description provided during connect",

                server_url: "external url provided during connect",

                gateway_pool: "production",

                remote_addr: "127.0.0.1",

                version: "9.9.9"            

            },

            status: {

                connected: true,

                blocked: false,

                in_current_state_since: "2021-01-01T00:00:00Z",

                minutes_in_current_state: 999

            },

            period: {

                period_start_date: "2021-01-01T00:00:00Z",

                period_end_date: "2021-12-31T23:59:59Z",

                period_seconds: 525600,

                connections: {

                    num_connections: 99,

                    most_recent_connection: "2021-01-01T00:00:00Z"

                },

                disconnections: {

                    num_disconnections: 99,

                    most_recent_disconnection: "2021-12-31T23:59:59Z"

                },

                total_uptime_seconds: 999,

                uptime_percentage: 99,

                avg_uptime_score: 99,

                avg_latency_ms: 99,

                avg_latency_score: 99,

                total_requests: 999,

                avg_success_rate: 99,

                avg_success_rate_score: 99,

                avg_reliability_score: 99,

                avg_staked_capacity_percent: 99,

                avg_utilization_percent: 99,

                total_pre_earned: 99.9999

            }

        }

    }

}



401: No autorizado

La solicitud contiene una clave de API incorrecta o faltante


Fuente oficial en ingleshttps://docs.presearch.org/nodes/api


Regístrese en Presearch, bonificación para nuevos usuarios de: regístrese en Presearch usando este enlace y obtenga 25 tokens PRE.


No hay comentarios.