外掛·加空品(?loc=<如 us-stlouis>):該地 US AQI + PM2.5 讀數(EPA/CAMS)

{ "discoverable": true, "method": "GET", "queryParams": { "loc": "required" }, "type": "http" }

{ "additionalProperties": true, "properties": { "_citation": { "description": "離線可驗證引用:{statement_type, not_advice:bool, claim, fact, source, record_hash, signature(Ed25519), key_id, issuer_DID(did:key), verify_url}。零信任自驗的信任根", "type": [ "object", "null" ] }, "addon": { "description": "(條件性:僅 /gauge/air|precip 子端點回傳)加值線標記", "enum": [ "air", "precip" ], "type": "string" }, "decision_points": { "description": "{count, points:[{tag,current,swappable,how}], note}。可換標籤重跑的決策點(換一個標籤=一次呼叫);不換用原語境為預設、不額外收費", "type": [ "object", "null" ] }, "grade": { "description": "資料分級誠實揭露(如 \"screening-level, not decision-grade\")", "type": [ "string", "null" ] }, "line": { "description": "本包所屬的線別(如 airquality)", "type": "string" }, "location": { "description": "本包的地理鍵(即呼叫時給的 ?loc=)", "type": "string" }, "name": { "description": "對象人類可讀名", "type": [ "string", "null" ] }, "nature": { "description": "中立聲明:GAUGE 只提供觀測與走勢描述,不判斷、不預測、不建議", "type": "string" }, "note": { "description": "(條件性)端點特定誠實揭露(邊界/粒度/免責);部分端點不回", "type": "string" }, "provenance": { "description": "資料血緣:{served_from, data_as_of, oldest_leg_as_of, data_age_hours(凍結齡,參考), age_hours_now(request-time 現算齡=freshness 的真依據), freshness(fresh|recent|stale), freshness_basis(該筆用的 cadence 與門檻,字串), dead_source(選配:源頭凍結/停產), data_lineage:[{signal,traceable_to,uncertainty,record_hash,...}], validation_status}。freshness 為 cadence-aware(月/季/年頻官方線不以 24h 誤判);同一判準與免費 /gauge/coverage 共用。買家可溯源到官方源", "type": [ "object", "null" ] }, "readings": { "description": "★本端點的核心交付:同一地點的多條訊號讀數,每筆形狀見 items(單訊號欄位在【這裡面】,不在頂層)", "items": { "additionalProperties": true, "properties": { "change": { "description": "變動。★按 metric 巢狀:change.<metric>={delta, direction};另有純量 change.period(如 \"vs_previous\")。direction 枚舉 rising/falling/stable", "type": [ "object", "null" ] }, "current": { "description": "當前讀數。★內部 metric 結構隨 signal 而異(crypto→{price_usd,volume_24h,...};shipping→{wind_kmh,wave_height_m,...})。單位以欄名後綴標示,另見 standard_ruler.unit", "type": [ "object", "null" ] }, "data_age_hours": { "description": "★採集當下凍結的齡(0=同小時),僅供參考——採集器停擺時本欄會凍結不動。判新鮮請一律用 provenance.age_hours_now(request-time 現算齡)與 provenance.freshness;門檻依據見 provenance.freshness_basis", "type": [ "number", "null" ] }, "entity": { "description": "監測對象 id(如 btc / us / hormuz);完整可查清單見免費 /gauge/catalog 或 /gauge/preview", "type": "string" }, "entity_name": { "description": "對象人類可讀名", "type": [ "string", "null" ] }, "hash_core_version": { "description": "record_hash 的 core 契約版本(現行 3);離線重算時據此選對 core 組法", "type": [ "integer", "null" ] }, "lifecycle": { "description": "生命週期區塊(state/birth_at/end_at/death_type/context…);★屬 record_hash v3 core 的一部分,離線重算必須帶上。非 lifecycle 類線為 null", "type": [ "object", "null" ] }, "observed_at": { "description": "資料真實觀測時間 ISO-8601", "type": "string" }, "ots_status": { "description": "OpenTimestamps 比特幣錨定狀態:pending(尚未錨定,record_hash+Ed25519 仍即時可驗) / anchored(已上鏈) / null", "type": [ "string", "null" ] }, "previous": { "description": "上一期讀數(current 的 metric 子集;或 {note} 說明無前值)", "type": [ "object", "null" ] }, "record_hash": { "description": "sha256:<64hex>(A 契約 v3,綁數值+provenance)。★離線重算 core 需要完整記錄欄位(snapshot_date/current/source_ref/source_tier/完整 standard_ruler/sources,以及 lifecycle 類線的 lifecycle)=主力 /gauge 交付的形狀;版本看同回應的 hash_core_version;$0.01–0.03 的單維外掛(ruler/calibrated/strata/history)交付的是【投影】,同一枚 hash 請以免費 /gauge/verify 覆核(我方重讀 DB 重算),或改買 /gauge 取完整 core 自行離線重算。無法雜湊時 null", "type": [ "string", "null" ] }, "record_hash_verifiable": { "description": "{mode:offline|via-endpoint, note}。★由伺服器【實算】判定本回應能否零連網重算出自己的 record_hash:offline=payload 含完整 canonical core;via-endpoint=投影過的交付(為控制體積省略部分 core 欄),請以免費 /gauge/verify 覆核或改買 /gauge", "type": [ "object", "null" ] }, "signal_id": { "description": "調取標籤(屬.種 ASCII 雙名法,如 crypto.spot / macro.unemployment / shipping.route-disruption);完整可查清單見免費 /gauge/catalog", "type": "string" }, "snapshot_date": { "description": "ISO-8601 date-time(UTC,如 2026-07-24T00:00:00.000Z;當日切齊零時)", "type": "string" }, "source_agreement_cv": { "description": "多源一致性變異係數(越小越一致);單源或不適用→null", "type": [ "number", "null" ] }, "source_ref": { "description": "官方來源 URL(provenance)", "type": [ "string", "null" ] }, "source_tier": { "description": "來源層級:T1(第一手官方) / T2 或 T2-<子類,如 T2-exchange>(可觀察·策展) / screen-viewpoint;null=未定級(見 unverified)", "type": [ "string", "null" ] }, "sources": { "description": "來源清單 [{name, value, weight, as_of, role}];多源時佐證 current", "items": { "type": "object" }, "type": [ "array", "null" ] }, "standard_ruler": { "description": "官方標準尺(band/閾值/normalized_index/pct_to_action;含 unit 與出處;無官方尺→null)。★內部結構隨 signal 而異", "type": [ "object", "null" ] }, "stat_ruler": { "description": "統計尺(近5年同季節經驗百分位落點;無統計→null)", "type": [ "object", "null" ] }, "strata": { "description": "統計分層(近5年同季節各官方層占比 + 現值落層;無統計→null)", "type": [ "object", "null" ] }, "summary_zh": { "description": "人類可讀總結(一句話 + 官方尺深淺 + 統計落點)", "type": [ "string", "null" ] }, "trend_7d": { "description": "近7期走勢點陣列;[]=此 signal 不適用或尚無序列(非錯誤)", "items": { "type": "object" }, "type": [ "array", "null" ] }, "unverified": { "description": "true=來源未定級(source_tier 為 null);買家/代理可據此過濾未定級資料", "type": "boolean" } }, "type": "object" }, "type": "array" }, "scope": { "description": "範圍與邊界誠實聲明(監測非預報、情報非指揮、可驗證保證的邊界)", "type": [ "string", "null" ] } }, "required": [ "nature", "readings" ], "type": "object" }