For developers
Dock a learning tool onto Stundentakt
Whoever builds a learning tool builds only its page — sign-in, storage, progress, lessons and the subscription come from Stundentakt.
- Sign-in: teachers and pupils sign in once with Stundentakt — with a class code, a sign-in card or beste.schule — and the tool gets a short-lived token, never a password.
- Storage: the tool keeps programs, vocabulary and settings per person; private unless she shares them with her class, her school or everyone.
- Progress: the tool reports what happened, and the teachers of the class see per task how far the class got — numbers only, no names.
- Lessons: a task in a medium, the whole medium around it, deadlines and hand-in work as everywhere else in Stundentakt.
- Subscription: the tool asks what the plan unlocks — a pupil carries the best plan of her classes, a child the plan of her parent.
Three steps
-
Read
The quickstart builds a whole tool in one HTML file without a library: sign-in with PKCE, the task, a draft, handing in.
Quickstart -
Register the tool
A teacher registers the start address and return address under “Learning tools” and passes you the client ID. Tools for every teacher are registered by the operator.
Learning tools -
Test
Put the tool into a medium, assign it to your class and open it as a pupil. It may run on localhost while you build it.
Learning tools for teachers
Documentation
The documentation is in German; the OpenAPI description and llms.txt are in English.
-
Overview
What Stundentakt does for a tool, the terms, what goes where, roles and modes, privacy.
/docs/developers/overview.md -
Quickstart
From an empty folder to a docked tool: register it, one complete HTML page without a library, test it.
/docs/developers/quickstart.md -
Recipes
Ready snippets: saving and sharing records, reporting progress, author mode with drafts, conflicts, signing out, errors, frame or window, my assignments, opening a pasted link, display per block.
/docs/developers/recipes.md -
Reference
The binding contract: launch, OAuth, every route and field, error reasons, CORS, limits and privacy.
/docs/developers/reference.md -
Learning tools for teachers
Register a tool, put it into a medium, assign it, what pupils see and the evaluation.
/docs/teachers/tools.md -
OpenAPI description
Every route of the tools API with scopes, request and response schemas and every error reason, as OpenAPI 3.1.
/api/v1/tools/openapi.json -
llms.txt
The index of this documentation for AI assistants, after llmstxt.org.
/llms.txt -
llms-full.txt
The index and every file of the documentation in one text.
/llms-full.txt