API Reference (v1)
The QD HTTP API serves a public, read-only corpus of educational practice
questions and platform metadata. All endpoints live under /v1/ and are
currently unauthenticated.
Base URL
Section titled “Base URL”https://api.qd.org/v1/Endpoints
Section titled “Endpoints”| Method | Path | Description |
|---|---|---|
GET | /health | Liveness probe. |
GET | /questions | List questions, with filtering. |
GET | /items/:item_id | Fetch a single item by id. |
GET | /spec | Machine-readable platform metadata. |
GET | /spec.md | Human-readable platform metadata (Markdown). |
See the per-endpoint pages in the sidebar for full request/response details.
Conventions
Section titled “Conventions”- All responses are JSON unless noted otherwise.
- Timestamps are ISO 8601, UTC.
- This is a placeholder overview — content authoring is in progress.