# OBOB.dog

> OBOB.dog helps kids practice for the Oregon Battle of the Books: practice battles, arcade games, printables and the Dog Eared Book Club, a parent-gated reading tracker with practice teams. It has a small read-only developer API for building your own OBOB things.

## Developer API

- [API documentation](https://obob.dog/developers.md): the whole developer page as Markdown: auth, limits, every endpoint with example responses, errors, and quick-start code in curl, JavaScript and Python.
- [OpenAPI 3.1 description](https://obob.dog/api/v1/openapi.json): the machine-readable version of the same.
- [Developer terms](https://obob.dog/developers/terms): what an API key holder agrees to.

Notes for agents: every endpoint is GET under https://obob.dog/api/v1 with `Authorization: Bearer obob_…`; reader and team codes travel in the `X-Reader-Code` / `X-Team-Code` headers, never in URLs; the daily question is the only question endpoint for now (no list or search yet, a policy decision); a `304` from `If-None-Match` is not counted against the 60-per-10-minute limit. Keys are made by a signed-in parent at https://obob.dog/developers.

## About

- [About OBOB.dog](https://obob.dog/about): who makes it and why.