API catalog

https://www.runflow.io/.well-known/api-catalog

{
  "linkset": [
    {
      "anchor": "https://api.runflow.io/",
      "service-desc": [
        { "href": "https://docs.runflow.io/api/openapi.public.json", "type": "application/json" }
      ],
      "service-doc": [
        { "href": "https://docs.runflow.io/api-reference/models/search-models", "type": "text/html" },
        { "href": "https://docs.runflow.io/", "type": "text/html" }
      ],
      "status": [
        { "href": "https://api.runflow.io/v1/health", "type": "application/json" }
      ]
    }
  ]
}

import requests
from requests.exceptions import RequestException

TIMEOUT = 5

try:
    r = requests.get("https://www.runflow.io/.well-known/api-catalog", timeout=TIMEOUT)
    r.raise_for_status()
    catalog = r.json()
    spec_url = catalog["linkset"][0]["service-desc"][0]["href"]

    r = requests.get(spec_url, timeout=TIMEOUT)
    r.raise_for_status()
    spec = r.json()
except RequestException as exc:
    raise SystemExit(f"Could not load Runflow API catalog: {exc}")