jaringan · Referensi perintah
qzx checkUrlStatus
Apa fungsinya
Mengueri URL HTTP dan mengembalikan kode status, waktu respons, serta header dasar.
Kematangan perintah: Alpha
Tersedia untuk penggunaan nyata dan umpan balik sementara antarmuka serta perilakunya masih dapat berkembang. Ini adalah evaluasi saat ini untuk checkout pengembangan. Setiap tag rilis immutable di masa mendatang akan mempertahankan evaluasi persis yang disertakan dalam versi tersebut. Tersedia di PyPI 0.2.2.0.9. Dokumentasi ini sesuai dengan checkout alpha 0.2.2.0.9.
Perilaku dan perlindungan bawaan
Memeriksa tanpa mengubah status
Eksekusi langsung untuk operasi ini
Berfungsi tanpa memanggil program native
Menggunakan jaringan untuk tugas yang didokumentasikan
Dirancang untuk bekerja tanpa elevasi hak akses
Klasifikasi keamanan ini ditinjau oleh OpenAI GPT-5.6 Pro terhadap digest implementasi sha256:1b206381bff908f537fd4221b934ab4e7d5769920e7c22032b9a1375cc6a18e3 pada 2026-08-25.
Sintaks persis
qzx checkUrlStatus <url> [timeout] --jsonParameter
Geser atau gunakan bilah horizontal untuk melihat semua kolom.
| Nama | Tipe | Wajib | Default | Deskripsi |
|---|---|---|---|---|
| url | str | Ya | Tidak dideklarasikan | URL target yang akan diperiksa (misalnya https://api.github.com) |
| timeout | float | Tidak | 5 | Timeout request dalam detik (default: 5.0) |
Contoh input
qzx checkUrlStatus https://api.github.comPeriksa apakah API GitHub dapat diakses dan ukur waktu responsnya
qzx checkUrlStatus https://httpbin.org/status/404 3.0Periksa URL dengan timeout khusus 3 detik
Untuk mendapatkan payload terstruktur lengkap, tambahkan --json: qzx checkUrlStatus <url> [timeout] --json
Contoh output yang diamati
Ditangkap dengan QZX 0.2.2.0.9 di Windows 11; kode keluar 0. Nilai yang bergantung pada host dan durasi dapat bervariasi.
Perintah contoh: qzx checkUrlStatus http://127.0.0.1:64884/ok 3 --json
{
"success": true,
"url": "http://127.0.0.1:64884/ok",
"is_online": true,
"response_time_ms": 33.47,
"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:64884/ok' is ONLINE (Status: 200 OK, Time: 33.47ms).",
"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": 44.926,
"schema_version": 1
}
}Lihat kontrak hasil 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
}Kesalahan dan batasan
Kontrak publik mensyaratkan success=false dan message yang deskriptif saat gagal. Katalog ini belum mendeklarasikan taksonomi kesalahan khusus untuk setiap perintah; periksa hasil dan jangan menyimpulkan kode yang tidak ada.
QZX masih dalam tahap alpha. Dependency opsional, izin, dan kemampuan host dapat mengubah hasil.
{
"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": 2.428,
"schema_version": 1
}
}Perintah yang ditangkap: qzx checkUrlStatus "" --json
Alur bukti: ditangkap dan divalidasi dengan digest.
Bukti dan asal-usul
- Implementasi
- src/qzx/commands/network/check_url_status.py
- Kanal dokumentasi
- Dokumentasi pengembangan 0.2.2.0.9 · main · sha256:cfba936e39931c286ca23add0ae546693db17d8b316e7cbc3891d26642d9b7e8
- Ketersediaan
- 0.2.2.0.9 atau lebih lama
Lanjut jelajahi
Perintah terkait
Perintah ini juga termasuk kategori jaringan. Bandingkan untuk memilih operasi yang paling sesuai bagi tugas Anda.
qzx checkSslCertificateMemeriksa tanggal sertifikat, cakupan nama host, dan validasi rantai kepercayaan.qzx diagnoseWebsiteMendiagnosis mengapa situs HTTPS mungkin gagal dengan mengorelasikan DNS, sertifikat TLS, dan jangkauan HTTP dalam satu alur.qzx checkDnsMengueri record DNS A, AAAA, MX, TXT, NS, dan CNAME dari sebuah domain.qzx getNetworkConfigMenampilkan interface, IP lokal, DNS, IP publik, dan deteksi VPN.