OrbitAlert API

curl https://api.orbitalert.net/health \
  -H "X-API-Key: sat_xk29mQpLvN3rT8wZ"

curl "https://api.orbitalert.net/passes?satellite=NOAA-20&lat=37.92&lon=23.73&hours=24" \
  -H "X-API-Key: sat_xk29mQpLvN3rT8wZ"

[
  {
    "satellite": "NOAA-20",
    "aos_utc": "2026-06-01T06:14:32Z",
    "los_utc": "2026-06-01T06:23:17Z",
    "tca_utc": "2026-06-01T06:18:54Z",
    "max_elevation_deg": 67.3,
    "duration_seconds": 525,
    "azimuth_at_aos": 342.1,
    "azimuth_at_los": 158.7
  },
  {
    "satellite": "NOAA-20",
    "aos_utc": "2026-06-01T14:53:08Z",
    "los_utc": "2026-06-01T15:01:44Z",
    "tca_utc": "2026-06-01T14:57:26Z",
    "max_elevation_deg": 22.8,
    "duration_seconds": 516,
    "azimuth_at_aos": 315.4,
    "azimuth_at_los": 197.2
  }
]

curl -X POST https://api.orbitalert.net/alerts \
  -H "X-API-Key: sat_xk29mQpLvN3rT8wZ" \
  -H "Content-Type: application/json" \
  -d '{
    "satellite_name": "NOAA-20",
    "observer_lat": 37.9195,
    "observer_lon": 23.7310,
    "webhook_url": "https://your-server.com/hook",
    "minutes_before": 10,
    "min_elevation": 15.0
  }'

{
  "id": "alert_8f3a12bc",
  "satellite_name": "NOAA-20",
  "observer_lat": 37.9195,
  "observer_lon": 23.7310,
  "webhook_url": "https://your-server.com/hook",
  "minutes_before": 10,
  "min_elevation": 15.0,
  "created_at": "2026-05-31T14:22:07Z"
}

curl https://api.orbitalert.net/space-weather \
  -H "X-API-Key: sat_xk29mQpLvN3rT8wZ"

{
  "kp_index": 3.2,
  "severity": "unsettled",
  "description": "Minor geomagnetic disturbance. Enhanced auroral activity above 60°N/S. No impact on VHF/UHF satellite links.",
  "updated_at": "2026-05-31T14:00:00Z"
}

{
  "event": "pass.upcoming",
  "alert_id": "alert_8f3a12bc",
  "satellite": "NOAA-20",
  "aos_utc": "2026-06-01T06:14:32Z",
  "los_utc": "2026-06-01T06:23:17Z",
  "tca_utc": "2026-06-01T06:18:54Z",
  "max_elevation_deg": 67.3,
  "duration_seconds": 525,
  "azimuth_at_aos": 342.1,
  "azimuth_at_los": 158.7,
  "kp_index": 3.2,
  "minutes_until_aos": 9,
  "observer": {
    "lat": 37.9195,
    "lon": 23.7310
  },
  "delivered_at": "2026-06-01T06:05:33Z"
}

{
  "error": "Invalid or missing API key.",
  "code": "unauthorized"
}

#!/usr/bin/env python3
"""
OrbitAlert quickstart — register an alert and print the webhook payload.
Run:  pip install requests && python quickstart.py
"""
import time, threading, requests
from http.server import HTTPServer, BaseHTTPRequestHandler

API_KEY = "sat_xk29mQpLvN3rT8wZ"          # replace with your key
WEBHOOK = "https://YOUR_NGROK_ID.ngrok.io/hook"  # expose :9000 via ngrok
BASE    = "https://api.orbitalert.net"

# 1. Local receiver — prints every incoming POST body
class Hook(BaseHTTPRequestHandler):
    def do_POST(self):
        n    = int(self.headers["Content-Length"])
        body = self.rfile.read(n).decode()
        print(f"\n>>> Webhook received:\n{body}\n")
        self.send_response(200)
        self.end_headers()
    def log_message(self, *_): pass

threading.Thread(
    target=HTTPServer(("", 9000), Hook).serve_forever,
    daemon=True,
).start()
print("Webhook receiver listening on :9000")

# 2. Register an alert — NOAA-20 over Athens, 10 min notice, ≥ 15° elevation
r = requests.post(f"{BASE}/alerts",
    headers={"X-API-Key": API_KEY},
    json={"satellite_name": "NOAA-20",
          "observer_lat": 37.9195, "observer_lon": 23.7310,
          "webhook_url": WEBHOOK,
          "minutes_before": 10, "min_elevation": 15.0})
r.raise_for_status()
print(f"Alert registered: {r.json()['id']}")
print("Waiting for the next NOAA-20 pass…  (Ctrl-C to quit)")
time.sleep(86400)