How to build a UFC or MMA app

// server.js — your app's backend (Node 18+). The key lives here, never in the app.
const API = "https://api.ufcalendar.com/v1";
const headers = { Authorization: `Bearer ${process.env.UFCAL_KEY}` };
const get = (path) => fetch(`${API}${path}`, { headers }).then((r) => r.json());

// Schedule screen: upcoming UFC cards, soonest first
const { data: events } = await get("/events?org=ufc");
for (const ev of events) console.log(ev.starts_at, ev.title, ev.is_ppv ? "PPV" : "");

// Fight card screen: one event with its whole card, in running order
const { data: next } = await get(`/events/${events[0].slug}`);
for (const f of next.card) console.log(f.weight_class, f.fighter_a?.name, "vs", f.fighter_b?.name);

// Results screen: winner, method, round and time once a bout is over
const { data: [last] } = await get("/events?org=ufc&status=completed&limit=1");
const { data: done } = await get(`/events/${last.slug}`);
for (const f of done.card.filter((x) => x.result)) {
  const winner = [f.fighter_a, f.fighter_b].find((c) => c?.id === f.result.winner_fighter_id);
  console.log(winner?.name ?? "draw / no contest", "by", f.result.method, `R${f.result.round} ${f.result.time}`);
}

// Fighter profile screen
const { data: fighter } = await get("/fighters/islam-makhachev");
console.log(fighter.name, fighter.career_stats.find((s) => s.scope === "pro-mma")?.record);

// Rankings screen: the current board
const { data: board } = await get("/rankings/ufc");
const lw = board.divisions.find((d) => d.division === "lightweight");
console.log("Champion:", lw?.entries.find((e) => e.rank === 0)?.name);

# backend.py — your app's backend. The key lives here, never in the app.
import os, requests

API = "https://api.ufcalendar.com/v1"
H = {"Authorization": f"Bearer {os.environ['UFCAL_KEY']}"}
get = lambda path, **params: requests.get(f"{API}{path}", params=params, headers=H).json()["data"]

# Schedule screen: upcoming UFC cards, soonest first
events = get("/events", org="ufc")
for ev in events:
    print(ev["starts_at"], ev["title"], "PPV" if ev["is_ppv"] else "")

# Fight card screen: one event with its whole card, in running order
event = get(f"/events/{events[0]['slug']}")
for f in event["card"]:
    print(f["weight_class"], (f["fighter_a"] or {}).get("name"), "vs", (f["fighter_b"] or {}).get("name"))

# Results screen: winner, method, round and time once a bout is over
last = get("/events", org="ufc", status="completed", limit=1)[0]
for f in get(f"/events/{last['slug']}")["card"]:
    r = f.get("result")
    if not r:
        continue
    corners = {c["id"]: c["name"] for c in (f["fighter_a"], f["fighter_b"]) if c}
    print(corners.get(r["winner_fighter_id"], "draw / no contest"), "by", r["method"], f"R{r['round']} {r['time']}")

# Fighter profile screen
fighter = get("/fighters/islam-makhachev")
print(fighter["name"], next((s["record"] for s in fighter["career_stats"] if s["scope"] == "pro-mma"), None))

# Rankings screen: the current board
board = get("/rankings/ufc")
lw = next(d for d in board["divisions"] if d["division"] == "lightweight")
print("Champion:", next((e["name"] for e in lw["entries"] if e["rank"] == 0), None))

// Pro and Business: let results come to you instead of polling on fight night
await fetch("https://api.ufcalendar.com/v1/webhook-endpoints", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.UFCAL_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ url: "https://example.com/hooks/ufcal", events: ["fight.result", "card.changed"] }),
});

// Your receiver: one signed delivery per result (X-UFCalendar-Signature header)
app.post("/hooks/ufcal", express.json(), async (req, res) => {
  const { type, data } = req.body;
  if (type === "fight.result") {
    await db.results.upsert(data.fight_id, data.result);          // a correction arrives as a new revision
    const headline = data.result.winner ? `${data.result.winner} wins by ${data.result.method}` : data.result.method;
    await push.toFollowers(data.fight_id, headline);
  }
  res.sendStatus(200);
});