flysafe-api (Python)

Lightweight Python client for the FlySafe airspace risk API. Synchronous, ~200 lines, only depends on requests.

Install

pip install flysafe-api

Quickstart

from flysafe import Client

fs = Client(api_key="...")

# Score a route
risk = fs.route_risk("LHR", "DXB")
print(risk["score"], risk["risk_level"])
# 54 high

# Engine v2 — adds reroute analysis + adjusted_score
fs2 = Client(api_key="...", engine_version="v2")
r = fs2.route_risk("LHR", "DXB", carrier="IL")
print(r["adjusted_score"])
print(r["reroute_analysis"]["best_alternative"]["path"])
# 53
# ['LCCC', 'OJAC', 'OEJD', 'OTBD', 'OMAE']

# Self-serve introspection
print(fs.usage()["daily_quota"])
print(fs.queries(status="429", limit=10))

Webhooks

Verify incoming webhook signatures:

from flysafe import verify_webhook

@app.post("/flysafe-hooks")
def receive():
    if not verify_webhook(SECRET, request.get_data(), request.headers["X-FlySafe-Signature"]):
        return "", 401
    event = request.headers["X-FlySafe-Event"]
    payload = request.get_json()
    # ...

Register a webhook:

created = fs.create_webhook(
    url="https://hooks.example.com/flysafe",
    events=["score.changed", "score.critical", "webhook.test"],
    description="Production OCC dashboard",
)
SECRET = created["signing_secret"]   # save it — shown only once

# Test it end-to-end
fs.fire_webhook_test(created["id"])

Errors

from flysafe import Client, FlySafeError, RateLimitError

try:
    fs.route_risk("LHR", "DXB")
except RateLimitError as e:
    print("retry after", e.retry_after, "seconds")
except FlySafeError as e:
    print("api error:", e.status, e.body)

Reference

Full API documentation: https://flysafe.zone/docs

License

MIT