REST API áttekintés

A tanulói felületed az lms/v1 REST API-ra épül. Három felület van:

Felület	Útvonal	Kinek
Nyilvános tanulói API	/wp-json/lms/v1/…	a frontendednek
Admin API	/wp-json/lw-lms/v1/admin/…	LMS-kezelőknek, adminisztrátoroknak
Abilities	/wp-json/wp-abilities/v1/…	WordPress 6.9-től

Végpontok

Végpont	Ki hívhatja	Részletek
GET /courses	bárki	Kurzusok
GET /courses/{id}	bárki	Kurzusok
GET /lessons/{id}	akinek van hozzáférése	Leckék és kvízek
POST /lessons/{id}/quiz	bejelentkezett, hozzáféréssel	Leckék és kvízek
GET /progress	bejelentkezett	Haladás
POST /progress	bejelentkezett, hozzáféréssel	Haladás
GET /progress/course/{id}	bejelentkezett	Haladás
GET /download/{id}	aláírt linkkel vagy bejelentkezve	Leckék és kvízek

Az alap URL: https://pelda.hu/wp-json/lms/v1/. Ha a szép permalinkek ki vannak kapcsolva: https://pelda.hu/?rest_route=/lms/v1/….

Ingyenes kurzusnál egy GET is feliratkoztat

Ha bejelentkezett felhasználó lekéri egy ingyenes kurzus részleteit (GET /courses/{id}) vagy megnyitja egy leckéjét (GET /lessons/{id}), a bővítmény feliratkozást rögzít „Ingyenes kurzus” forrással, és lefut a lw_lms_after_grant akció is. A kurzuslista (GET /courses) soha nem iratkoztat fel.

A katalógus-oldalad ezért a listából dolgozzon. A kurzus részletező oldalának megnyitása már beiratkozásnak számít.

Hitelesítés

• Külön frontend vagy alkalmazás: WordPress-alkalmazásjelszó HTTP Basic hitelesítéssel. A tanuló a Felhasználók → Profil → Alkalmazásjelszavak részen hozza létre.
• Ugyanazon a domainen futó téma: a bejelentkezési süti és az X-WP-Nonce fejléc (wp_rest nonce).

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é.

Válaszok

• A válasz JSON. A lapozás adatai a válasz meta objektumában vannak, nem az X-WP-Total fejlécben.
• Hibánál: { "code": "…", "message": "…", "data": { "status": 4xx } }. Az üzenet a webhely nyelvén jön, magyar oldalon magyarul.

A WordPress saját lecke-végpontja zárva van

A /wp-json/wp/v2/lesson csak szerkesztőknek válaszol. Mindenki más ezt kapja: „A leckék az LMS API-n keresztül érhetők el (/lms/v1/lessons).” A frontend mindig az lms/v1 végpontokat hívja.