network · Command reference
qzx checkUrlStatus
What it does
Requests an HTTP(S) URL and reports its status code, response time, and basic headers.
Command maturity: Alpha
Available for real use and feedback while its interface and behavior can still evolve. This is the current development-checkout assessment. Every future immutable release tag preserves the exact assessment shipped by that version. Available in PyPI 0.2.2.0.8. This page documents the 0.2.2.0.8 alpha development checkout.
Behavior and built-in protections
Inspects without changing state
Direct execution for this operation
Works without invoking native programs
Uses network access for the documented task
No elevation required by design
This safety classification was reviewed by OpenAI GPT-5.6 Pro against implementation digest sha256:1b206381bff908f537fd4221b934ab4e7d5769920e7c22032b9a1375cc6a18e3 on 2026-08-25.
Exact syntax
qzx checkUrlStatus <url> [timeout] --jsonParameters
Swipe or use the horizontal scrollbar to see every column.
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| url | str | Yes | Not declared | Target URL to check (e.g., https://api.github.com) |
| timeout | float | No | 5 | Request timeout in seconds (default: 5.0) |
Input examples
qzx checkUrlStatus https://api.github.comVerify if GitHub API is accessible and check response times
qzx checkUrlStatus https://httpbin.org/status/404 3.0Check a URL with a custom 3-second timeout
For the complete structured payload, add --json: qzx checkUrlStatus <url> [timeout] --json
Observed output example
Captured with QZX 0.2.2.0.8 on Windows 11; exit code 0. Host-dependent values and duration can vary.
Example command: 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
}
}View the JSON result contract
{
"$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
}Errors and limits
The public contract requires success=false and a descriptive message on failure. This catalog does not yet declare a command-specific error taxonomy; inspect the result and do not invent error codes.
QZX is alpha software. Optional dependencies, permissions, and host capabilities can change the result.
{
"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
}
}Captured command: qzx checkUrlStatus "" --json
Evidence workflow: captured and digest-validated.
Evidence and provenance
- Implementation
- src/qzx/commands/network/check_url_status.py
- Documentation channel
- Development documentation 0.2.2.0.8 · main · sha256:9aa902dfb6b006017e52972bf7871fef49b03ec24ff80741231d743d0354bfc2
- Availability
- 0.2.2.0.8 or earlier
Keep exploring
Related commands
These commands also belong to the network category. Compare them to choose the operation that best fits your task.
qzx checkSslCertificateInspects certificate dates, hostname coverage, and trust-chain validationqzx getNetworkConfigDisplays comprehensive network status (interfaces, local IPs, DNS, public IP, VPN detection)qzx checkDnsQueries A, AAAA, MX, TXT, NS, and CNAME DNS records for a given domainqzx testInternetSpeedMeasures HTTP latency in milliseconds and bounded download throughput in Mbps and MiB/s