hubvibe-io.com

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "description": "The 200 body of every paid /work call. `result` is the worker's own output (its schema is per route); everything else is the same on every /work route. A receipt for the job is at `receipt_url`.",
  "properties": {
    "attribution": {
      "$ref": "#/components/schemas/Attribution"
    },
    "billing_warning": {
      "description": "Present only when the charge was recorded with a caveat.",
      "examples": [
        "settlement pending"
      ],
      "type": "string"
    },
    "price_usd": {
      "description": "What this call cost, in USD.",
      "examples": [
        0.02
      ],
      "type": "number"
    },
    "provenance": {
      "$ref": "#/components/schemas/Provenance"
    },
    "receipt_id": {
      "description": "Receipt id for this job.",
      "examples": [
        "rcpt_9f1c2b3a4d5e6f70"
      ],
      "type": "string"
    },
    "receipt_url": {
      "description": "Where to fetch the machine-readable receipt (free, no payment).",
      "examples": [
        "/work/receipts/rcpt_9f1c2b3a4d5e6f70"
      ],
      "type": "string"
    },
    "result": {
      "properties": {
        "alerts": {
          "description": "Active US National Weather Service alerts; empty outside the US or when none.",
          "examples": [
            []
          ],
          "items": {
            "description": "An active NWS alert.",
            "properties": {
              "effective": {
                "description": "From.",
                "examples": [
                  "2026-09-28T12:00:00-05:00"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "event": {
                "description": "Alert type.",
                "examples": [
                  "Air Quality Alert"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "expires": {
                "description": "Until.",
                "examples": [
                  "2026-09-29T00:00:00-05:00"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "headline": {
                "description": "Headline.",
                "examples": [
                  "Air Quality Alert issued September 28 ..."
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "severity": {
                "description": "Severity.",
                "examples": [
                  "Moderate"
                ],
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "event",
              "severity",
              "headline",
              "effective",
              "expires"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "alerts_covered": {
          "description": "Whether alerts were checked (US points).",
          "examples": [
            true
          ],
          "type": "boolean"
        },
        "attribution": {
          "description": "Credits to show with the data.",
          "items": {
            "description": "A required credit.",
            "properties": {
              "license": {
                "description": "Licence.",
                "examples": [
                  "CC BY 4.0"
                ],
                "type": "string"
              },
              "text": {
                "description": "Credit.",
                "examples": [
                  "Data from MET Norway"
                ],
                "type": "string"
              },
              "url": {
                "description": "Link.",
                "examples": [
                  "https://www.met.no/en"
                ],
                "type": "string"
              }
            },
            "required": [
              "text",
              "url",
              "license"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "checked_at": {
          "description": "When this node read the source (UTC). Nothing here is cached.",
          "examples": [
            "2026-09-26T18:00:00Z"
          ],
          "format": "date-time",
          "type": "string"
        },
        "current": {
          "$ref": "#/components/schemas/HourlyItem"
        },
        "daily": {
          "description": "Up to seven days.",
          "items": {
            "description": "One day.",
            "properties": {
              "condition": {
                "description": "Midday symbol.",
                "examples": [
                  "partlycloudy_day"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "date": {
                "description": "Day (UTC).",
                "examples": [
                  "2026-09-29"
                ],
                "type": "string"
              },
              "max_c": {
                "description": "High.",
                "examples": [
                  21.4
                ],
                "type": [
                  "number",
                  "null"
                ]
              },
              "min_c": {
                "description": "Low.",
                "examples": [
                  12.1
                ],
                "type": [
                  "number",
                  "null"
                ]
              },
              "precipitation_mm": {
                "description": "Total precipitation.",
                "examples": [
                  1.2
                ],
                "type": "number"
              }
            },
            "required": [
              "date",
              "min_c",
              "max_c",
              "precipitation_mm",
              "condition"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "forecast_updated_at": {
          "description": "When MET Norway last updated this forecast.",
          "examples": [
            "2026-09-28T13:18:23Z"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "hourly": {
          "description": "The next 24 hours.",
          "items": {
            "$ref": "#/components/schemas/HourlyItem"
          },
          "type": "array"
        },
        "location": {
          "description": "Location as given; null when coordinates were sent.",
          "examples": [
            "Kyoto"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "notes": {
          "description": "Caveats; empty when none.",
          "examples": [
            []
          ],
          "items": {
            "description": "A caveat.",
            "examples": [
              "alerts: NWS alerts timed out"
            ],
            "type": "string"
          },
          "type": "array"
        },
        "place": {
          "description": "The point forecast.",
          "properties": {
            "country": {
              "description": "ISO country when known.",
              "examples": [
                "US"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "lat": {
              "description": "Latitude.",
              "examples": [
                35.0117
              ],
              "type": "number"
            },
            "lon": {
              "description": "Longitude.",
              "examples": [
                135.7683
              ],
              "type": "number"
            },
            "name": {
              "description": "Where it resolved.",
              "examples": [
                "Kyoto (city in Japan)"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "source": {
              "description": "How the place was found.",
              "examples": [
                "Wikidata Q34600"
              ],
              "type": "string"
            }
          },
          "required": [
            "name",
            "lat",
            "lon",
            "country",
            "source"
          ],
          "type": "object"
        },
        "sections_failed": {
          "description": "Empty when none.",
          "examples": [
            []
          ],
          "items": {
            "description": "A section whose source did not answer.",
            "examples": [
              "alerts"
            ],
            "type": "string"
          },
          "type": "array"
        },
        "units": {
          "description": "Units.",
          "properties": {
            "precipitation": {
              "description": "Unit.",
              "examples": [
                "mm"
              ],
              "type": "string"
            },
            "pressure": {
              "description": "Unit.",
              "examples": [
                "hPa"
              ],
              "type": "string"
            },
            "temperature": {
              "description": "Unit.",
              "examples": [
                "celsius"
              ],
              "type": "string"
            },
            "wind_speed": {
              "description": "Unit.",
              "examples": [
                "m/s"
              ],
              "type": "string"
            }
          },
          "required": [
            "temperature",
            "wind_speed",
            "precipitation",
            "pressure"
          ],
          "type": "object"
        }
      },
      "required": [
        "location",
        "place",
        "current",
        "hourly",
        "daily",
        "alerts",
        "alerts_covered",
        "units",
        "forecast_updated_at",
        "attribution",
        "sections_failed",
        "notes",
        "checked_at"
      ],
      "type": "object"
    },
    "status": {
      "const": "ok",
      "description": "Present only on a delivered result.",
      "type": "string"
    },
    "worker": {
      "description": "Catalog name of the worker that ran.",
      "examples": [
        "market.quote"
      ],
      "type": "string"
    }
  },
  "required": [
    "status",
    "worker",
    "price_usd",
    "result",
    "provenance",
    "receipt_id",
    "receipt_url"
  ],
  "title": "maps.weather response",
  "type": "object"
}