Base URL: https://api.games.ihnyc-rc.org Auth: Public + Admin (Access or token)
Public endpoints
| Path | Method | Auth | Purpose |
|---|---|---|---|
/api/health | GET | Public | Health check |
/api/events | GET | Public | List events |
/api/events/:id | GET | Public | Fetch one event |
/api/standings | GET | Public | Medal table by floor |
/api/rosters/summary | GET | Public | Roster totals by building/floor |
Response envelope:
{ ok: boolean, data?: any, error?: string }
Admin endpoints
| Path | Method | Auth | Purpose |
|---|---|---|---|
/api/admin/events | GET/POST | Admin | List/create events |
/api/admin/events/:id | PATCH | Admin | Update event |
/api/admin/results | GET/POST | Admin | Get/save results |
/api/admin/results/:id | DELETE | Admin | Delete result row |
/api/admin/import/csv | POST | Admin | Import CSV submissions |
/api/admin/imports | GET | Admin | Import run history |
/api/admin/submissions | GET | Admin | Submission review |
/api/admin/submissions/:id | DELETE | Admin | Delete submission |
Admin auth
Accept either:
- Cloudflare Access headers (
cf-access-*, including service tokens), or X-Admin-TokenmatchingADMIN_TOKEN(dev only).
Import parameters
?preview=1: parse CSV and return a preview without writing.?delta=1: only insert rows newer than the latestresponse_at.?since=ISO8601: optional override for delta cutoff.