Website Uptime & TLS Status Check

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string"
    },
    "method": {
      "type": "string"
    },
    "timeout_ms": {
      "type": "integer"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "tls": {
      "type": "boolean",
      "description": "Whether the connection used TLS. Present whether the target is up or down."
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "Stripped. Always null in the output; it is the same URL the caller submitted, so it carries no additional information."
    },
    "error": {
      "type": "string",
      "description": "A short error description, e.g. 'fetch failed'. Only present when the target is down -- not present at all on a successful check."
    },
    "status": {
      "type": "string",
      "description": "Observed values: 'up' and 'down'."
    },
    "headers": {
      "type": "object",
      "properties": {
        "server": {
          "type": "string"
        },
        "content_type": {
          "type": "string"
        },
        "x_powered_by": {
          "type": [
            "string",
            "null"
          ],
          "description": "Observed null when the target does not send this header."
        }
      },
      "description": "Only present when the target is up -- not present at all when the target is unreachable.",
      "additionalProperties": true
    },
    "final_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "Stripped. Always null in the output even on a successful, redirected check."
    },
    "checked_at": {
      "type": "string",
      "description": "ISO 8601 timestamp of when this check was performed."
    },
    "latency_ms": {
      "type": "number",
      "description": "Round-trip time of the check itself, in milliseconds."
    },
    "redirected": {
      "type": "boolean",
      "description": "Whether the request followed a redirect. Only present when the target is up -- not present at all when the target is unreachable."
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "HTTP status code, e.g. 200. Observed null when the target could not be reached at all (the request never received a response)."
    },
    "status_text": {
      "type": "string",
      "description": "HTTP status text, e.g. 'OK'. Only present when the target is up -- not present at all when the target is unreachable."
    }
  },
  "description": "The uptime-check result.",
  "additionalProperties": true
}