CanQuiz

Send the person's answer to the question siguiente_tarjeta gave, with its turno. With options (forma una or varias): elegidas are the letters the person chose, or [] if they do not know; CanQuiz decides whether it was right. Open question (forma texto): first send the person's own words in respuesta; CanQuiz returns the solution and saves nothing yet. Compare strictly and call again with the same turno and a nota: otra_vez, dificil, bien or facil. The answer returns whether it was right, the correct answer with its explanation and when the question comes back; then call siguiente_tarjeta. Sending the same turno twice records it only once (ya_respondida).

responder_tarjeta

Delete one of the person's quizzes, with its practice history. It cannot be undone: show the person the title and wait for a clear yes before calling. titulo is the title you showed the person; if it does not match the quiz, nothing is deleted (titulo_no_coincide). One quiz per call. not_found after a deletion means the quiz is already gone.

borrar_test

Change one of the person's quizzes: its title, its description or its questions. Operations run in order and either all of them are applied or none: añadir adds a question (at the end, or right after despues_de); cambiar changes some fields of the question id_pregunta; quitar removes the question id_pregunta. In cambiar, send only the fields you change; never send back text you did not change. If ver_test marked an explanation explicacion_recortada, leave explicacion out to keep it: sending the shortened text back is rejected (explicacion_recortada). version is the one ver_test returned. If the quiz changed since then, the answer is test_cambiado and nothing is applied: call ver_test again. A quiz cannot be left without questions.

editar_test

List the person's own quizzes in CanQuiz, most recently changed first, without their questions, each with enlace to open it in CanQuiz. Use buscar to find a quiz by words in its title. When hay_mas is true, call again with desde set to the number of quizzes already listed.

listar_tests

Make one of the person's quizzes private again, so only the person can open it. People who have its link can no longer open it; sharing it again later brings back the same link. If it was listed in the public CanQuiz catalogue, it leaves the catalogue too. If it is already private, nothing changes. Returns the visibility it had before and enlace, the person's own link to open it. not_found means it is not a quiz in this account.

dejar_de_compartir

Get the next question the person has to practise now, from all their quizzes with practice turned on, or from one quiz with test. Show the question and its options with their letters exactly as given. Give no hints, never reveal or guess the answer and never answer for the person: wait for their answer and send it to responder_tarjeta with this turno. hay_tarjeta false means nothing is due now; proxima_en says when the next question comes back.

siguiente_tarjeta

Open one of the person's quizzes: title, description, visibility, enlace (the link that opens it in CanQuiz), version and its questions with their ids, options, correct answers and explanations. Explanations over 2000 characters come shortened (explicacion_recortada). Use desde and cuantas to page through a long quiz. Call it before editar_test, which needs the version and the question ids. not_found means it is not a quiz in this account.

ver_test

How the person's practice is going: questions due now, new questions that fit today, questions done today, accuracy over the last 30 days, when the next one comes back, and the same per quiz with practice turned on. enlace_repaso opens that practice in CanQuiz. With test, only that quiz. Read only.

resumen_de_repaso

Save a new quiz in the person's CanQuiz account. You write the questions, from the topic or the notes the person gives you, and CanQuiz checks and saves them. The quiz is private until the person shares it. Rules: up to 50 questions per call (add more afterwards with editar_test); single_choice and multiple_choice questions have 4 options; true_false has exactly two; correcta is the exact text of the correct option (a list for multiple_choice); write every question in the language of the material, each with a short explanation. Repeating the same call within 10 minutes returns the same quiz instead of a copy (ya_existia). Returns the quiz id, its version and enlace, the link that opens it in CanQuiz.

crear_test

Get a link so other people can open one of the person's quizzes. If the quiz is private, it becomes visible to anyone who has the link; it is not published anywhere else. If it was already shared, nothing changes. Tell the person before sharing. Only for sharing with others: to open their own quiz, the person needs the enlace that listar_tests, ver_test, crear_test and editar_test return, which changes nothing. dejar_de_compartir makes it private again. retirado means moderation withdrew the quiz and it cannot be shared.

compartir_enlace