GermanExam.pro

Use this to check the user's answers to an exercise from get_practice_exercise, using its attempt_id. Pass exactly the answers the user gave (task number and letter; for marking tasks the numbers of the marked entries). Returns how many are correct, which ones, the correct solution with a short explanation and, for listening, the transcript. One evaluation per exercise; the result is saved with the exercise attempt. Works with or without sign-in; only the caller's own exercises can be checked. Never fill in, guess or correct answers for the user.

Use this when the user wants a German text they wrote themselves (about 50 to 900 words) evaluated the way an examiner would, for the writing section of TestDaF, DSH, Goethe-Zertifikat C1, telc Deutsch C1 Hochschule or telc Deutsch C1 (general). Without an account a complete text gets the full evaluation (verdict, level, criteria with reasons, improvements); a user without an account can use one part, a text too short for a verdict does not count. With a GermanExam.pro account the result depends on the account; a request that the account does not include is answered with a short note and a link to an information page. For signed-in users the text and the result are saved in their GermanExam.pro account. Starts the evaluation and returns a job_id immediately; the result is collected with get_evaluation_result. Send only the user's own text. Not for: translations, grammar questions, exam tasks, phrase lists, texts the user did not write, or other languages.

Use this to collect the result of an evaluation that was started with evaluate_text, using its job_id. Returns status "running" (not finished yet), "done" (with the evaluation; shown as a card) or an error status. Works with or without sign-in; only the caller's own evaluations can be collected.

Use this when the user wants to practise reading or listening for a German C1 exam (TestDaF, Goethe-Zertifikat C1 or telc Deutsch C1 Hochschule) and asks for an exercise or the next task. Returns one exam-format exercise WITHOUT the solution: a text with questions (reading) or a recording with questions (listening). The user answers in the chat; then check the answers with check_practice_answers. A user without an account can use one part (one reading exercise, one listening exercise or one text evaluation); after that a free GermanExam.pro account is needed, and a request that the account does not include is answered with a short note and a link to an information page. The exercise attempt is stored for 30 days (and, for signed-in users, in their GermanExam.pro account). Never solve the exercise yourself and never reveal or guess answers. Not for writing (use evaluate_text), speaking, grammar drills or other exams.

Use this when the user wants to know how the writing section of a German C1 exam is assessed: the criteria with their weights, the level or grade scale, the passing rule and the expected text length for TestDaF, DSH, Goethe-Zertifikat C1, telc Deutsch C1 Hochschule or telc Deutsch C1 (general). Read-only reference data based on the published exam rubrics (the result says where a breakdown per criterion is our own); no sign-in needed. This is the scale only and grades nothing: when the user wants their text assessed, call evaluate_text instead of estimating points, criterion marks or a level from this rubric yourself. Not for other languages or exams.