HTTP Redirect Chain Tracer

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

{
  "type": "object",
  "properties": {
    "chain": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "The URL requested at this hop."
          },
          "step": {
            "type": "number",
            "description": "1-indexed hop position."
          },
          "server": {
            "type": "string",
            "description": "The Server response header, e.g. 'gws', 'cloudflare'."
          },
          "location": {
            "type": [
              "string",
              "null"
            ],
            "description": "The Location response header for this hop. null on a hop that did not redirect (e.g. the final 200)."
          },
          "latency_ms": {
            "type": "number",
            "description": "Time in milliseconds for this single hop."
          },
          "status_code": {
            "type": "number"
          },
          "status_text": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "description": "One entry per hop, in order, starting with the original URL. A direct (non-redirecting) URL still produces a single-entry chain for its own 200 response."
    },
    "issues": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Problems detected while tracing (e.g. a redirect loop). Empty on both real calls observed."
    },
    "final_url": {
      "type": "string",
      "description": "The URL reached after following every redirect hop (equals original_url when redirect_count is 0)."
    },
    "uses_https": {
      "type": "boolean",
      "description": "Whether the final URL uses HTTPS."
    },
    "same_domain": {
      "type": "boolean",
      "description": "Whether the final URL stayed on the same domain as the original."
    },
    "original_url": {
      "type": "string",
      "description": "The URL exactly as submitted."
    },
    "redirect_count": {
      "type": "number",
      "description": "Number of redirect hops followed. 0 on a direct, non-redirecting URL."
    },
    "total_latency_ms": {
      "type": "number",
      "description": "Total time in milliseconds across every hop."
    },
    "final_status_code": {
      "type": "number",
      "description": "The HTTP status code of the final hop."
    }
  },
  "description": "The redirect trace result, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": true
}