Skip to content

Leckék és kvízek végpontjai

A GET /lessons/{id}, a kvíz beküldése, az ütemezés miatti zárolás, a kvíz-korlát és a mellékletek letöltése.

This content is not available in your language yet.

A példák WordPress-alkalmazásjelszót használnak (-u "felhasználó:jelszó"). A tanulo:… a tanuló saját fiókja, az admin:… egy adminisztrátoré.

Ki nyithatja meg: nyitott kurzus leckéjét bárki; előnézeti leckét bejelentkezett felhasználó; minden mást az, akinek hozzáférése van a kurzushoz. Ingyenes kurzus leckéjének első megnyitása bejelentkezve feliratkozást rögzít.

Terminál (hozzáférés nélkül)
curl "https://pelda.hu/wp-json/lms/v1/lessons/37"
Válasz
{ "code": "forbidden", "message": "Nincs hozzáférésed ehhez a leckéhez.", "data": { "status": 403 } }

Hozzáféréssel a válasz alakja:

Válasz (alak)
{
"id": 37, "title": "…", "content": "<p>…</p>",
"course": { "id": 35, "title": "…" },
"section": null,
"order": 0, "duration": "45m",
"video": { "provider": "youtube", "…": "…", "html": "<iframe …>" },
"attachments": [],
"navigation": { "previous": null, "next": { "id": 38, "title": "…" } },
"quiz": { "pass_percentage": 80, "shuffle_options": false,
"questions": [ { "id": "q1", "type": "single", "prompt": "…", "options": [ { "id": "a", "text": "…" } ] } ],
"last_attempt": null }
}
  • A video és a quiz értéke null, ha a leckén nincs ilyen.
  • A video.html kész lejátszó-markup. A video többi mezője a szolgáltatótól függ.
  • A kvízkérdések a helyes válasz nélkül jönnek.

Lezárt leckére 403 lesson_locked jön. A data.locked_reason mondja meg, miért:

locked_reason Üzenet
sequence „Végezd el az előző leckét, hogy ez megnyíljon.”
schedule „Ez a lecke még nem érhető el.”

A data.available_at ISO-dátum: ekkor nyílik meg a lecke. Egy tanuló zárolásait adminként a wp lw-lms drip status parancs mutatja (WP-CLI).

Kvíz beküldése: POST /lessons/{id}/quiz

Szekció neve “Kvíz beküldése: POST /lessons/{id}/quiz”

Bejelentkezett felhasználó küldheti, ha hozzáfér a leckéhez, és az nincs zárolva.

Terminál
curl -u "tanulo:xxxx xxxx xxxx xxxx xxxx xxxx" -X POST -H "Content-Type: application/json" \
-d '{"answers":{"q1":"b","q2":true,"q3":"Szabad szöveges válasz"}}' \
"https://pelda.hu/wp-json/lms/v1/lessons/37/quiz"
Válasz (alak)
{ "score": 2, "scored_questions": 2, "percentage": 100, "passed": true, "pass_percentage": 80,
"results": { "q1": { "correct": true }, "q2": { "correct": true }, "q3": { "scored": false } } }
  • Egyválasztósnál a válasz az opció id-ja vagy a 0-tól számolt sorszáma.
  • Igaz/hamis kérdésnél JSON true vagy false kell. A "true" szöveg rossz válasznak számít.
  • Nyitott kérdésnél szöveg. Nem pontozott; a results a mintaválaszt is visszaadhatja sample kulcsban.
  • A válasz nem árulja el a helyes opciót.

Korlát: két beküldés között alapból 15 másodperc, és leckénként napi 20 kísérlet. Fölötte 429 quiz_rate_limited jön: „Túl sok kvízkitöltés. Várj egy kicsit, mielőtt újra próbálod.” A data.retry_after mondja meg, hány másodperc múlva próbálkozhat újra. A korlátok szűrővel állíthatók (Fejlesztőknek).

A mellékletek download_url-je a GET /download/{id} végpontra mutat. A link aláírt, és alapból egy óráig érvényes. Lejárt linknél 403 download_link_expired: „Ez a letöltési link érvénytelen vagy lejárt. Töltsd újra az oldalt egy új linkért.” Ilyenkor kérd le újra a kurzust vagy a leckét.

We respect your privacy

We use cookies to improve your browsing experience and to analyse traffic. Analytics only starts if you allow it. Privacy policy, Cookie policy.

Cookie settings