red · Referencia de comando
qzx checkUrlStatus
Qué hace
Consulta una URL HTTP y devuelve código de estado, tiempo de respuesta y cabeceras básicas.
Madurez del comando: Alpha
Disponible para uso real y retroalimentación mientras su interfaz y comportamiento todavía pueden evolucionar. Esta es la evaluación actual del checkout de desarrollo. Cada futuro tag inmutable de release conservará la evaluación exacta incluida en esa versión. Disponible en PyPI 0.2.2.0.8. La documentación corresponde al checkout alpha 0.2.2.0.8.
Comportamiento y protecciones integradas
Inspecciona sin cambiar el estado
Ejecución directa para esta operación
Funciona sin invocar programas nativos
Usa la red para la tarea documentada
Diseñado para funcionar sin elevación
Esta clasificación de seguridad fue revisada por OpenAI GPT-5.6 Pro contra el digest de implementación sha256:1b206381bff908f537fd4221b934ab4e7d5769920e7c22032b9a1375cc6a18e3 el 2026-08-25.
Sintaxis exacta
qzx checkUrlStatus <url> [timeout] --jsonParámetros
Desliza o usa la barra horizontal para ver todas las columnas.
| Nombre | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
| url | str | Sí | No declarado | URL de destino que se comprobará (por ejemplo, https://api.github.com) |
| timeout | float | No | 5 | Timeout de la solicitud en segundos (valor predeterminado: 5.0) |
Ejemplos de entrada
qzx checkUrlStatus https://api.github.comComprobar si la API de GitHub está accesible y medir sus tiempos de respuesta
qzx checkUrlStatus https://httpbin.org/status/404 3.0Comprobar una URL con un timeout personalizado de 3 segundos
Para obtener la carga estructurada completa, añade --json: qzx checkUrlStatus <url> [timeout] --json
Ejemplo de salida observada
Capturado con QZX 0.2.2.0.8 en Windows 11; código de salida 0. Los valores dependientes del host y la duración pueden variar.
Comando del ejemplo: qzx checkUrlStatus http://127.0.0.1:64811/ok 3 --json
{
"success": true,
"url": "http://127.0.0.1:64811/ok",
"is_online": true,
"response_time_ms": 41.66,
"status_code": 200,
"reason": "OK",
"headers": {
"Content-Type": "text/plain",
"Content-Length": "2",
"Server": "QZX-evidence ",
"Date": "Sat, 08 Aug 2026 00:00:00 GMT",
"Cache-Control": "no-store"
},
"message": "URL 'http://127.0.0.1:64811/ok' is ONLINE (Status: 200 OK, Time: 41.66ms).",
"meta": {
"command": "checkUrlStatus",
"command_maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
},
"duration_ms": 45.422,
"schema_version": 1
}
}Ver el contrato de resultado JSON
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"required": [
"success",
"message",
"meta"
],
"properties": {
"success": {
"type": "boolean"
},
"message": {
"type": "string"
},
"meta": {
"type": "object",
"required": [
"command",
"command_maturity",
"duration_ms",
"schema_version"
],
"properties": {
"command": {
"type": "string"
},
"command_maturity": {
"type": "object",
"required": [
"stage",
"label",
"sequence",
"public_executable",
"stability",
"summary",
"promotion_review_required",
"assessment_scope"
],
"properties": {
"stage": {
"type": "string"
},
"label": {
"type": "string"
},
"sequence": {
"type": "integer"
},
"public_executable": {
"type": "boolean"
},
"stability": {
"type": "string"
},
"summary": {
"type": "string"
},
"promotion_review_required": {
"type": "boolean"
},
"assessment_scope": {
"type": "string"
},
"note": {
"type": "string"
},
"review": {
"type": "object",
"required": [
"reviewed_on",
"rationale",
"evidence"
],
"properties": {
"reviewed_on": {
"type": "string",
"format": "date"
},
"rationale": {
"type": "string"
},
"evidence": {
"type": "array",
"minItems": 1,
"items": {
"type": "string"
}
},
"replacement": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": true
},
"duration_ms": {
"type": "number"
},
"schema_version": {
"type": "integer"
}
},
"additionalProperties": true
},
"error": {
"type": "string"
},
"error_code": {
"type": "string"
},
"headers": [],
"is_online": [],
"reason": [],
"response_time_ms": [],
"status_code": [],
"status_detail": [],
"url": []
},
"additionalProperties": true
}Errores y límites
El contrato público exige success=false y un message descriptivo en fallos. Este catálogo aún no declara una taxonomía de errores específica para cada comando; revisa el resultado y no infieras códigos inexistentes.
QZX está en alpha. Dependencias opcionales, permisos y capacidades del host pueden cambiar el resultado.
{
"success": false,
"message": "URL cannot be empty.",
"error": "URL cannot be empty.",
"error_code": "invalid_url",
"meta": {
"command": "checkUrlStatus",
"command_maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
},
"duration_ms": 6.112,
"schema_version": 1
}
}Comando capturado: qzx checkUrlStatus "" --json
Flujo de evidencia: capturada y validada por digest.
Evidencia y procedencia
- Implementación
- src/qzx/commands/network/check_url_status.py
- Canal de documentación
- Documentación de desarrollo 0.2.2.0.8 · main · sha256:9aa902dfb6b006017e52972bf7871fef49b03ec24ff80741231d743d0354bfc2
- Disponibilidad
- 0.2.2.0.8 o anterior
Sigue explorando
Comandos relacionados
Estos comandos también pertenecen a la categoría de red. Compáralos para elegir la operación que mejor resuelva tu tarea.
qzx checkSslCertificateInspecciona fechas del certificado, cobertura del nombre de host y validación de la cadena de confianza.qzx getNetworkConfigMuestra interfaces, IP locales, DNS, IP pública y detección de VPN.qzx checkDnsConsulta registros DNS A, AAAA, MX, TXT, NS y CNAME de un dominio.qzx testInternetSpeedMide la latencia HTTP en milisegundos y una descarga limitada en Mbps y MiB/s.