R4X — Statistics API v1

Analytics for the iTheorie apps: product usage, and question statistics that feed the catalogue work. Aggregate-only and monthly-bucketed. Next.js on Vercel + Neon Postgres.

Endpoints

• POST /v1/answers/batch — batched idempotent ingest (HMAC signed)
• GET /v1/apps/:appID/question-stats — windowed export, paginated (HMAC signed)
• GET /v1/apps/:appID/snapshot.csv — CDN-cacheable social-proof snapshot (key only)
• POST /v1/admin/apps/:appID/grounding — one-time grounding import (admin token)
• GET /v1/health — liveness

Auth: per-app appKey/appSecret with HMAC request signing (X-App-Key, X-Timestamp, X-Nonce, X-Signature). No name, email, IP address or advertising identifier is stored.