Design Critique

curl example

curl -sS \
  "https://example-data.com/api/v1/calendar-events/444" \
  -H "Accept: application/json"

JavaScript example

const res = await fetch(
  "https://example-data.com/api/v1/calendar-events/444"
);
const calendarEvent = await res.json();

TypeScript example

// Download once: mkdir -p types && curl -o types/calendar-events.d.ts https://example-data.com/types/calendar-events.d.ts
import type { CalendarEvent } from "./types/calendar-events";

const res = await fetch(
  "https://example-data.com/api/v1/calendar-events/444"
);
const calendarEvent = (await res.json()) as CalendarEvent;

Python example

import requests

res = requests.get(
    "https://example-data.com/api/v1/calendar-events/444"
)
calendar_event = res.json()