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ámetro: start_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ámetro: connected (OPCIONAL)
Tipo: boolean
Descripción: true| false: los nodos conectados actualmente deben incluirse en la lista devuelta
(Predeterminado: true)
Parámetro: desconnected (OPCIONAL)
Tipo: boolean
Descripción: true| false: los nodos desconectados actualmente deben incluirse en la lista devuelta
(Predeterminado: true)
Parámetro: include_inactive (OPCIONAL)
Tipo: boolean
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 ingles: https://docs.presearch.org/nodes/api
No hay comentarios.