GermanExam.pro

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. Not for evaluating a text (use evaluate_text) and not for other languages or exams.

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 sign-in the result shows the passages an examiner would mark and the biggest risk (a user without an account can use one part). With the user's GermanExam.pro sign-in the result also includes the verdict (is it enough, level, how close it is); 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 verdict or, without sign-in, the reduced report; 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 the user's sign-in 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 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.