ovahub
Ir a la documentación
DocumentaciónReferencia de la APIListar redes privadas
GETToken Bearer

Listar redes privadas

/api/v1/networks

Consulte hasta 100 instantáneas locales de redes de la organización actual, ordenadas por ID. Una página vacía no confirma su ausencia en el proveedor.

Antes de llamar

Solo lectura local, sin solicitudes al proveedor, cobros ni escrituras. Todas las capabilities son false; coincidir en región o proveedor no demuestra compatibilidad ni conexión segura.

Los nombres de campos, los tipos y el código de la API se mantienen iguales en todos los idiomas.

Ejemplo de petición

cURL
curl "https://tovahub.com/api/v1/networks" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

Solo ejemplos. Esta página no envía peticiones.

Respuesta ilustrativa
JSON
{
  "networks": [],
  "nextCursor": null,
  "source": "local",
  "verification": "unknown",
  "capabilities": {
    "purchase": false,
    "attach": false,
    "disconnect": false,
    "remove": false,
    "reconnect": false,
    "cancelAddon": false,
    "renew": false,
    "resize": false,
    "delete": false,
    "blockedReason": "Private network supplier actions are not verified. Billing requires verified supplier support; local snapshots do not establish compatibility or safe attachment."
  }
}

Parámetros

afterConsulta · Opcional

string

Cursor opcional de 24 caracteres hexadecimales de nextCursor (lista de redes) o portsNextCursor (detalle). Devuelve hasta 100 filas con ID mayor que el cursor; null indica que no hay otra página.

Respuesta

Estado HTTP 200

Consulte hasta 100 instantáneas locales de redes de la organización actual, ordenadas por ID. Una página vacía no confirma su ausencia en el proveedor.

networksobject[]

Consulte hasta 100 instantáneas locales de redes de la organización actual, ordenadas por ID. Una página vacía no confirma su ausencia en el proveedor.

networks[].idstring

Identificador de la plataforma, no del proveedor.

networks[].providerstring

Valor de la instantánea local almacenada, no un estado del proveedor verificado en vivo.

networks[].namestring

Valor de la instantánea local almacenada, no un estado del proveedor verificado en vivo.

networks[].regionstring

Valor de la instantánea local almacenada, no un estado del proveedor verificado en vivo.

networks[].dataCenterstring | null

Valor de la instantánea local almacenada, no un estado del proveedor verificado en vivo.

networks[].cidrstring | null

CIDR privado registrado, o null si no se ha observado.

networks[].boundServersinteger | null

Número de conexiones activas a servidores físicos actuales de la organización; null si el recuento es incoherente.

networks[].occupiedPortsinteger | null

Reservas locales activas, incluidas las pendientes y en proceso de retirada; null si la ocupación es incoherente.

networks[].capacityinteger

Valor de la instantánea local almacenada, no un estado del proveedor verificado en vivo.

networks[].statestring

Valor de la instantánea local almacenada, no un estado del proveedor verificado en vivo.

networks[].versioninteger

Valor de la instantánea local almacenada, no un estado del proveedor verificado en vivo.

networks[].monthlyPricestring

Centavos enteros de USD como cadena, no dólares; un precio publicado no habilita el pago.

networks[].serviceFromstring (ISO 8601) | null

El servicio empieza solo tras confirmar la compra; null si se desconoce.

networks[].serviceUntilstring (ISO 8601) | null

Fin del servicio pagado en la plataforma, independiente de las fechas pagadas al proveedor; null si se desconoce.

networks[].autoRenewboolean

Solo es una preferencia de renovación; no demuestra pago ni ampliación.

networks[].accessStatestring

Estado local guardado del acceso a la red: active, stopping, stopped, restoring o unknown. No verifica la conectividad actual del proveedor.

networks[].currency"USD"

Moneda fija USD, unidad cent y período month cuando se incluye.

networks[].priceUnit"cent"

Moneda fija USD, unidad cent y período month cuando se incluye.

networks[].checkedAtstring | null

Fecha de comprobación de la instantánea en ISO 8601, o null si se desconoce. No es una verificación en vivo.

networks[].testOnlyboolean

True solo marca un contexto de prueba, que puede incluir servidores reales comprados. No demuestra simulación ni omite cobros o controles de seguridad.

networks[].source"local"

Siempre local; no se realiza ninguna consulta en vivo al proveedor.

networks[].verification"unknown" | "snapshot"

snapshot si existe checkedAt; de lo contrario, unknown. Ninguno verifica el estado actual del proveedor.

networks[].capabilitiesobject

Los nueve indicadores son false: purchase, attach, disconnect, remove, reconnect, cancelAddon, renew, resize y delete. Las capacidades del proveedor aún no están verificadas y no se cobra hasta verificarlas; las instantáneas no prueban compatibilidad ni conexión segura.

nextCursorstring | null

Cursor opcional de 24 caracteres hexadecimales de nextCursor (lista de redes) o portsNextCursor (detalle). Devuelve hasta 100 filas con ID mayor que el cursor; null indica que no hay otra página.

source"local"

Siempre local; no se realiza ninguna consulta en vivo al proveedor.

verification"unknown"

Siempre unknown; un resultado local vacío no prueba ausencia en el proveedor.

capabilitiesobject

Los nueve indicadores son false: purchase, attach, disconnect, remove, reconnect, cancelAddon, renew, resize y delete. Las capacidades del proveedor aún no están verificadas y no se cobra hasta verificarlas; las instantáneas no prueban compatibilidad ni conexión segura.

Relacionado

Peticiones y erroresAutenticaciónMCP · list_networks