\n\nFIGYELEM! A dokumentáció szinte teljes egészében elavult. A legtöbb dokumentált API endpoint már részben vagy teljesen lecserélésre került.
\n
A KRÉTA Ellenőrző Android/iOS alkalmazás által használt mobil API nem hivatalos dokumentációja.
\nKészítette:
\nBizonyos nyelveken például ahol nem lehet kisbetűs header-t beállítani, vagy böngészőből való teszteléskor, rákerül a lekérésre egy header, ezek lehetetlenné teszik a KRÉTA több API-jával a kommunikációt. Boa részletesebben foglalkozott ezzel és más hibákkal, az ő API dokumentációja itt található.
\nA krétások (pontosan nem tudni, hogy ezen belül ki foglalkozik ezzel) elkezdték a nem hivatalos klienseket blokkolni / lassítani. Ez User-Agent alapján történik, amit a legtöbb lekéréshez el kell küldeni header formájában. Néhány nem hivatalos projekt a hivatalos User-Agent-et használja, a KRÉTA tudtunkkal erről nem foglalt álláspontot.
\nkreta vagy az android szoreszleteket. (Rájött: Unknown)Dalvik/2.1.0 (Linux; U; Android 9; XXXXX Build/XXXXXX): Az Arisztokréta régebbi verziói ezt használták, ez egy cordova plugin alapértelmezett User-Agent-je, telefononként változottkreta vagy android és Dalvik szórészleteket egyszerre. (Rájött: Unknown)7856d350-1fda-45f5-822d-e1a2f3f1acf0Az intézmények lekéréséhez szükséges, minden KRÉTA felhasználónak ugyanaz.
\n919e0c1c-76a2-4646-a2fb-7085bbbf3c56A bejelentkezéshez szükséges (Access Token lekérése, frissítése), minden KRÉTA felhasználónak ugyanaz.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Fontos tudnivalók","slug":"fontos-tudnivalok"}],"owner":"10379752","collectionId":"3dd389d7-ec41-45f0-b384-66d0b59c8560","publishedId":"SzKPULz6","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2020-02-13T21:03:53.000Z"},"item":[{"name":"Bejelentkezés","item":[{"name":"KRÉTA API linkek lekérése","id":"9c6fac68-d6c7-41eb-bf14-6015f273e436","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://kretamobile.blob.core.windows.net/configuration/ConfigurationDescriptor.json","description":"Lekérhetjük a jelenleg használt KRÉTA mobil API linkeket, hogy ne kelljen minden alkalommal frissíteni az appot, ha változnak. A hivatalos KRÉTA alkalmazás mindig a \"GlobalMobileApiUrlPROD\" linket használja. Akár egy böngészővel is kipróbálhatjuk.
\n","urlObject":{"protocol":"https","path":["configuration","ConfigurationDescriptor.json"],"host":["kretamobile","blob","core","windows","net"],"query":[],"variable":[]}},"response":[{"id":"47b6450a-cd77-4e94-80a2-1317a3f6c760","name":"KRÉTA API linkek lekérése","originalRequest":{"method":"GET","header":[],"url":"https://kretamobile.blob.core.windows.net/configuration/ConfigurationDescriptor.json"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"295"},{"key":"Content-Type","value":"application/json"},{"key":"Content-MD5","value":"ev3vS6qrtK7E8SCb8p/kqg=="},{"key":"Last-Modified","value":"Wed, 06 Jun 2018 11:50:02 GMT"},{"key":"ETag","value":"0x8D5CBA3A3733EC8"},{"key":"Server","value":"Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0"},{"key":"x-ms-request-id","value":"e2604c54-801e-003a-394e-e2b894000000"},{"key":"x-ms-version","value":"2009-09-19"},{"key":"x-ms-lease-status","value":"unlocked"},{"key":"x-ms-blob-type","value":"BlockBlob"},{"key":"Date","value":"Thu, 13 Feb 2020 09:15:25 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"GlobalMobileApiUrlDEV\": \"https://kretaglobalmobileapiuat.ekreta.hu\",\n \"GlobalMobileApiUrlTEST\": \"https://kretaglobalmobileapitest.ekreta.hu\",\n \"GlobalMobileApiUrlUAT\": \"https://kretaglobalmobileapiuat.ekreta.hu\",\n \"GlobalMobileApiUrlPROD\": \"https://kretaglobalmobileapi.ekreta.hu\"\n}"}],"_postman_id":"9c6fac68-d6c7-41eb-bf14-6015f273e436"},{"name":"Intézmények lekérése","id":"e647ac25-4988-4352-a231-17af6a74608a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"apiKey"},{"key":"value","value":"7856d350-1fda-45f5-822d-e1a2f3f1acf0"}]},"isInherited":false},"method":"GET","header":[],"url":"https://kretaglobalmobileapi.ekreta.hu/api/v1/Institute","description":"Lekéri a KRÉTA rendszert használó intézmények listáját. Bejelentkezésnél a felhasználó választ egy intézményt amire szükség lesz:
\nInstituteCode-ot el kell küldeni a bejelentkezési adatokkal együtt.Url-re kell küldeniHeader-ként el kell küldeni az apiKey-t, ez mindenkinek ugyanaz: 7856d350-1fda-45f5-822d-e1a2f3f1acf0
Felhasználónév
\n"},{"key":"password","value":"xxxxxxxxxxxxxx","equals":true,"description":"A felhasználónévhez tartozó jelszó
\n"},{"key":"institute_code","value":"XXXXXXXXXX","equals":true,"description":"A felhasználó által választott intézmény Url-je
Minden KRÉTA felhasználónak ugyanaz
\n"}]},"url":"https://XXXXXXXXXX.e-kreta.hu/idp/api/v1/Token","description":"Lekér a megadott felhasználónévvel, jelszóval és intézmény azonosítóval egy Bearer tokent.
\nBelépés után egy fél óráig érvényes JWT access_token-t kapunk, amivel a többi API endpointot elérhetjük. A későbbiekben új access_token-t a refresh_token segítségével kérhetünk, ami korlátlan ideig érvényes (azonban csak egyszer lehet használni). A felhasználó jelszavát ezért nem szükséges, és nem is ajánlott eltárolni.
Maga az access_token egy szabványos JWT token, amit dekódolva a bejelentkezett felhasználóra jellemző információkat kaphatunk. (Bővebben: https://jwt.io)
\nAz Arisztokréta alkalmazás az itt található decodeToken() függvény segítségével dekódolja az access_token-t.
Ha az access_token lejárt, refresh_token birtokában újat igényelhetünk. A refresh_token egyszer használatos, ezért megújításkor új refresh_token-t is kapunk.
Bearer token lekérése felhasználónévvel és jelszóval vagy refresh_token-el
Bejelentkezés során kapott access_token
Lekéri a felhasználó órarendjét két dátum között.
\n","urlObject":{"path":["mapi","api","v1","Lesson"],"host":["https://XXXXXXXXXX.e-kreta.hu"],"query":[{"key":"fromDate","value":"2020-02-13"},{"key":"toDate","value":"2020-02-13"}],"variable":[]}},"response":[{"id":"ffeef1e8-b16b-4a7f-9c78-1dfcae310062","name":"Órarend - Régi","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer xxxxxxxxxxxxxx","equals":true,"description":"Bejelentkezés során kapott `access_token`"},{"key":"Accept","value":"application/json","type":"text"},{"key":"User-Agent","value":"Kreta.Ellenorzo/2.9.8.2020012301 (Android; XX-XXXX 0.0)","type":"text"}],"url":{"raw":"https://XXXXXXXXXX.e-kreta.hu/mapi/api/v1/Lesson?fromDate=2020-02-13&toDate=2020-02-13","host":["https://XXXXXXXXXX.e-kreta.hu"],"path":["mapi","api","v1","Lesson"],"query":[{"key":"fromDate","value":"2020-02-13"},{"key":"toDate","value":"2020-02-13"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Content-Length","value":"4103"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Expires","value":"-1"},{"key":"X-Robots-Tag","value":"noindex"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff "},{"key":"Strict-Transport-Security","value":"max-age=16070400; includeSubDomains"},{"key":"Content-Security-Policy","value":"default-src 'none' ;script-src 'self' 'unsafe-inline' 'unsafe-eval' https://js-agent.newrelic.com https://bam.nr-data.net https://www.googletagmanager.com https://www.google-analytics.com https://www.gstatic.com http://www.google.com; frame-src https://www.google.com/ https://idp.e-kreta.hu ; style-src 'self' 'unsafe-inline' https://fonts.googleapis.com; img-src * data: https:;connect-src 'self'; font-src 'self' https://fonts.googleapis.com https://fonts.gstatic.com; form-action 'self';"},{"key":"Date","value":"Thu, 13 Feb 2020 12:44:00 GMT"},{"key":"Set-Cookie","value":"TS019cd799=018aec130bf8e3a875a6130c463cf79b73c57d12cd69fa0f18404e2def4a58f47ab74ca90a680e7483775d156e867cc5a3fd9bb5a9; Path=/; Domain=.e-kreta.hu"}],"cookie":[],"responseTime":null,"body":"[\r\n {\r\n \"LessonId\": 000000,\r\n \"CalendarOraType\": \"Xxxxxxx\",\r\n \"Count\": 0,\r\n \"Date\": \"2069-04-20T00:00:00\",\r\n \"StartTime\": \"2069-04-20T00:00:00\",\r\n \"EndTime\": \"2069-04-20T00:00:00\",\r\n \"Subject\": \"xxxxxx\",\r\n \"SubjectCategory\": null,\r\n \"SubjectCategoryName\": \"Xxxxxx\",\r\n \"ClassRoom\": \"Xxxxxx\",\r\n \"OsztalyCsoportUid\": \"000000\",\r\n \"ClassGroup\": \"Xxxxx\",\r\n \"Teacher\": \"Xxxxxxxxx Xxxxxxx\",\r\n \"DeputyTeacher\": \"\",\r\n \"State\": \"Xxxxxxx\",\r\n \"StateName\": \"Xxxxxxx xxxxxx\",\r\n \"PresenceType\": \"Xxxxxx\",\r\n \"PresenceTypeName\": \"Xxx xxx xxxx xxxxxxx\",\r\n \"TeacherHomeworkId\": null,\r\n \"IsTanuloHaziFeladatEnabled\": false,\r\n \"BejelentettSzamonkeresIdList\": [],\r\n \"Theme\": \"Xxxxxxxxxxxxxxxxxxx\",\r\n \"Nev\": \"xxxxxxx\",\r\n \"Homework\": null\r\n },\r\n {...}\r\n]"}],"_postman_id":"39b10b97-cffd-4575-970c-e32b548b2015"},{"name":"🔒 Órarend - Új (AMI) ","id":"d48a1589-a6b5-4fe3-84c9-1cb57a5b11b2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer xxxxxxxxxxxxxx","equals":true,"description":"Bejelentkezés során kapott access_token
Lekéri a felhasználó órarendjét két dátum között.
\n","urlObject":{"path":["mapi","api","v1","LessonAmi"],"host":["https://XXXXXXXXXX.e-kreta.hu"],"query":[{"key":"fromDate","value":"2020-02-13"},{"key":"toDate","value":"2020-02-13"}],"variable":[]}},"response":[{"id":"c0472cbb-4b3c-4220-85b8-774faa1cdc0c","name":"Órarend lekérése","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer xxxxxxxxxxxxxx","equals":true,"description":"Bejelentkezés során kapott `access_token`"},{"key":"Accept","value":"application/json","type":"text"},{"key":"User-Agent","value":"Kreta.Ellenorzo/2.9.8.2020012301 (Android; XX-XXXX 0.0)","type":"text"}],"url":{"raw":"https://XXXXXXXXXX.e-kreta.hu/mapi/api/v1/LessonAmi?fromDate=2020-02-13&toDate=2020-02-13","host":["https://XXXXXXXXXX.e-kreta.hu"],"path":["mapi","api","v1","LessonAmi"],"query":[{"key":"fromDate","value":"2020-02-13"},{"key":"toDate","value":"2020-02-13"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Content-Length","value":"4118"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Expires","value":"-1"},{"key":"X-Robots-Tag","value":"noindex"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff "},{"key":"Strict-Transport-Security","value":"max-age=16070400; includeSubDomains"},{"key":"Content-Security-Policy","value":"default-src 'none' ;script-src 'self' 'unsafe-inline' 'unsafe-eval' https://js-agent.newrelic.com https://bam.nr-data.net https://www.googletagmanager.com https://www.google-analytics.com https://www.gstatic.com http://www.google.com; frame-src https://www.google.com/ https://idp.e-kreta.hu ; style-src 'self' 'unsafe-inline' https://fonts.googleapis.com; img-src * data: https:;connect-src 'self'; font-src 'self' https://fonts.googleapis.com https://fonts.gstatic.com; form-action 'self';"},{"key":"Date","value":"Thu, 13 Feb 2020 09:59:42 GMT"},{"key":"Set-Cookie","value":"TS019cd799=018aec130bd63aebb4ecdc9b777bdd7426c60838341d7275544ad67e3712b83dba2c6f74094a11a237eed29c0141e1061f1546875b; Path=/; Domain=.e-kreta.hu"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"LessonId\": 000000,\n \"CalendarOraType\": \"Xxxxxxx\",\n \"Count\": 0,\n \"Date\": \"2069-04-20T00:00:00\",\n \"StartTime\": \"2069-04-20T00:00:00\",\n \"EndTime\": \"2069-04-20T00:00:00\",\n \"Subject\": \"xxxxxx\",\n \"SubjectCategory\": null,\n \"SubjectCategoryName\": \"Xxxxxx\",\n \"ClassRoom\": \"Xxxxxx\",\n \"OsztalyCsoportUid\": \"000000\",\n \"ClassGroup\": \"Xxxxx\",\n \"Teacher\": \"Xxxxxxxxx Xxxxxxx\",\n \"DeputyTeacher\": \"\",\n \"State\": \"Xxxxxxx\",\n \"StateName\": \"Xxxxxxx xxxxxx\",\n \"PresenceType\": \"Xxxxxx\",\n \"PresenceTypeName\": \"Xxx xxx xxxx xxxxxxx\",\n \"TeacherHomeworkId\": null,\n \"IsTanuloHaziFeladatEnabled\": false,\n \"BejelentettSzamonkeresIdList\": [],\n \"Theme\": \"Xxxxxxxxxxxxxxxxxxx\",\n \"Nev\": \"xxxxxxx\",\n \"Homework\": null\n },\n {...}\n]"}],"_postman_id":"d48a1589-a6b5-4fe3-84c9-1cb57a5b11b2"}],"id":"c4dfdf27-3f27-4656-b699-725f87d4d8f9","description":"Az órarend lekérésére jelenleg kettő API áll rendelkezésre, tudomásom szerint mindkettő pontosan ugyanazt csinálja és pontosan ugyanúgy működik, a válaszidőben, a visszakapott adatokban nincs különbség. A hivatalos KRÉTA alkalmazás régebben a .../Lesson API-t használta, azonban jelenleg már a .../LessonAmi-t. Valószínű, hogy az előbbit le akarják selejtezni, ezért azt javaslom, hogy mindenki a .../LessonAmi-t használja.
A KRÉTA egyébként említi az AMI modult a tudásbázisában:
\n\n\nAz AMI-k számára kifejlesztett, az Összetett intézményekben többes jogviszonyt, több osztályba tartozást lehetővé tevő modul bekapcsolásához mind a tiszta AMI, mind az Összetett intézmény számára szükséges, hogy a Nyilvántartás / Intézmény menüpontban beállításra kerüljön Alapfokú művészetoktatás vagy Művészeti szakgimnázium ellátott köznevelési feladat.
\n
Forrás és további információ: https://tudasbazis.ekreta.hu/pages/viewpage.action?pageId=33325156
\n","_postman_id":"c4dfdf27-3f27-4656-b699-725f87d4d8f9"},{"name":"Felhasználó adatai","item":[{"name":"🔒 Felhasználó adatai - Új (AMI)","id":"9d69acbb-b6fb-457c-9b18-6587597094cd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer xxxxxxxxxxxxxx","equals":true,"description":"Bejelentkezés során kapott access_token
Információk az újabb API-val kapcsolatban:
\n.../Student elküldi a tanuló tanulmányi átlagait SubjectAverages-ként, ami a .../StudentAmi-nál null. Ahhoz, hogy ezesetben megkapjuk ezeket az adatokat, a .../TantargyiAtlagAmi lekérdezést kell használnunk (A hivatalos KRÉTA app is így csinálja). Érdekesség, hogy a .../TantargyiAtlagAmi visszaad egy plusz mezőt is, amit a .../Student nem csinált, ez a SortIndex.OsztalyCsoportok elrendezése eltér a két API-nak.../Student lekérdezésben még szerepelt a TanuloAktualisOktatasNevelesiKategoriaja, ezt kivették, a .../StudentAmi nem tartalmazzaHa az értéke null vagy kihagyjuk ezt a paramétert, az összes a KRÉTA rendszerben lévő adatot visszakapjuk (tehát az egész évet)
\n","type":"text/plain"},"key":"fromDate","value":"2019-09-01"},{"description":{"content":"Ha az értéke null vagy kihagyjuk ezt a paramétert, az összes a KRÉTA rendszerben lévő adatot visszakapjuk (tehát az egész évet)
\n","type":"text/plain"},"key":"toDate","value":"2020-01-01"}],"variable":[]}},"response":[{"id":"e8c66e3b-c89e-403a-b786-52e8c2e5ef11","name":"Felhasználó adatai - Új (AMI)","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer xxxxxxxxxxxxxx","equals":true,"description":"Bejelentkezés során kapott `access_token`"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"},{"key":"Accept","value":"application/json","type":"text"},{"key":"User-Agent","value":"Kreta.Ellenorzo/2.9.8.2020012301 (Android; XX-XXXX 0.0)","type":"text"}],"url":{"raw":"https://XXXXXXXXXX.e-kreta.hu/mapi/api/v1/StudentAmi?fromDate=2019-09-01&toDate=2020-01-01","host":["https://XXXXXXXXXX.e-kreta.hu"],"path":["mapi","api","v1","StudentAmi"],"query":[{"key":"fromDate","value":"2019-09-01"},{"key":"toDate","value":"2020-01-01"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Content-Length","value":"83587"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Expires","value":"-1"},{"key":"X-Robots-Tag","value":"noindex"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff "},{"key":"Strict-Transport-Security","value":"max-age=16070400; includeSubDomains"},{"key":"Content-Security-Policy","value":"default-src 'none' ;script-src 'self' 'unsafe-inline' 'unsafe-eval' https://js-agent.newrelic.com https://bam.nr-data.net https://www.googletagmanager.com https://www.google-analytics.com https://www.gstatic.com http://www.google.com; frame-src https://www.google.com/ https://idp.e-kreta.hu ; style-src 'self' 'unsafe-inline' https://fonts.googleapis.com; img-src * data: https:;connect-src 'self'; font-src 'self' https://fonts.googleapis.com https://fonts.gstatic.com; form-action 'self';"},{"key":"Date","value":"Thu, 13 Feb 2020 12:58:21 GMT"},{"key":"Set-Cookie","value":"TS019cd799=018aec130b14918b85db8615e2133ef73157818af0dd497615529813da67e666cd39d09b2f90a9d89c2f051c63f36e21ec154224b3; Path=/; Domain=.e-kreta.hu"}],"cookie":[],"responseTime":null,"body":"{\n\t//hiányzik a \"TanuloAktualisOktatasNevelesiKategoriaja\", amit a \".../Lesson\" API visszaad\n \"StudentId\": 0,\n \"SchoolYearId\": 0,\n \"Name\": \"Xxxxxx Xxxxx\",\n \"NameOfBirth\": \"Xxxxxx Xxxxx\",\n \"PlaceOfBirth\": \"Xxxxxxxxx\",\n \"MothersName\": \"Xxxxxx Xxxxx\",\n \"AddressDataList\": [\n \"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\",\n \"...\"\n ],\n \"DateOfBirthUtc\": \"2069-04-20T09:38:23\",\n \"InstituteName\": \"Xxxxxx Xxxxx\",\n \"InstituteCode\": \"Xxxxxxxxx\",\n \"Evaluations\": [\n {\n \"EvaluationId\": 0,\n \"Form\": \"Xxxx\",\n \"FormName\": \"Xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\",\n \"Type\": \"Xxxxxx\",\n \"TypeName\": \"Xxxxxx\",\n \"Subject\": \"Xxxxxx xxxxx\",\n \"SubjectCategory\": null,\n \"SubjectCategoryName\": \"Xxxxxx\",\n \"Theme\": \"Xxxxx\",\n \"IsAtlagbaBeleszamit\": true,\n \"Mode\": \"Xxxxxx\",\n \"Weight\": \"0%\",\n \"Value\": \"Xxxxxx\",\n \"NumberValue\": 0,\n \"SeenByTutelaryUTC\": null,\n \"Teacher\": \"Xxxxx Xxxxx\",\n \"Date\": \"2069-04-20T09:38:23\",\n \"CreatingTime\": \"2069-04-20T09:38:23\",\n \"Jelleg\": {\n \"Id\": 0,\n \"Nev\": \"Xxxxxx\",\n \"Leiras\": \"Xxxxxxx\"\n },\n \"JellegNev\": \"Xxxxxx\",\n \"ErtekFajta\": {\n \"Id\": 0,\n \"Nev\": \"Xxxxxxx\",\n \"Leiras\": \"XXxxxxxx\"\n },\n \"OsztalyCsoportUid\": \"000000\"\n },\n {...}\n ],\n \"SubjectAverages\": null, //A \".../Lesson\" API itt visszaadja a tantárgyi átlagokat\n \"Absences\": [\n {\n \"AbsenceId\": 0,\n \"Type\": \"Xxxxxx\",\n \"TypeName\": \"Xxxxxx\",\n \"Mode\": \"Xxxxx\",\n \"ModeName\": \"Xxxxx xxxxxx\",\n \"Subject\": \"xxxxx\",\n \"SubjectCategory\": null,\n \"SubjectCategoryName\": \"Xxxxx\",\n \"DelayTimeMinutes\": 0,\n \"Teacher\": \"Xxxxxxx Xxxxxxx\",\n \"LessonStartTime\": \"2069-04-20T09:38:23\",\n \"NumberOfLessons\": 0,\n \"CreatingTime\": \"2069-04-20T09:38:23\",\n \"JustificationState\": \"Xxxxxxx\",\n \"JustificationStateName\": \"Xxxxxx xxxxx\",\n \"JustificationType\": \"Xxxxxxx\",\n \"JustificationTypeName\": \"Xxxxx xxxxx\",\n \"SeenByTutelaryUTC\": null,\n \"OsztalyCsoportUid\": \"000000\"\n },\n {...}\n ],\n \"Notes\": [\n {\n \"NoteId\": 0,\n \"Type\": \"Xxxxxxx\",\n \"Title\": \"Xxxxxxx\",\n \"Content\": \"Xxxxxx xxxxx xxxx xxxxxxxx xxx xxx\",\n \"SeenByTutelaryUTC\": null,\n \"Teacher\": \"Xxxxx Xxxx Xxxxx\",\n \"Date\": \"2069-04-20T09:38:23\",\n \"CreatingTime\": \"2069-04-20T09:38:23\",\n \"OsztalyCsoportUid\": \"000000\"\n },\n {...}\n ],\n \"OsztalyCsoportok\": [ //Teljesen más felépítés, mint a \".../Lesson API-nál\"\n {\n \"OktatasNevelesiFeladat\": {\n \"Uid\": \"0000\",\n \"Leiras\": \"Xxxxxxx\",\n \"Nev\": \"xxxxxxx\"\n },\n \"OktatasNevelesiKategoria\": {\n \"Uid\": \"0000\",\n \"Leiras\": \"Xxxxxx xxxx\",\n \"Nev\": \"Xxxxx xxxxxx\"\n },\n \"Nev\": \"xxxxxx\",\n \"OsztalyCsoportTipus\": \"xxxxxx\",\n \"IsAktiv\": true,\n \"Uid\": \"000000\",\n \"OsztalyfonokUid\": \"000000\"\n },\n {...}\n ],\n \"Lessons\": null,\n \"Events\": null,\n \"FormTeacher\": null, //itt null, \".../Lesson\" API-nál van (egyébként teljesen felesleges) adat\n \"Osztalyfonokok\": [\n {\n\t\t\t\"Uid\": \"000000\",\n \"Tanar\": {\n \"Uid\": \"000000\",\n \"Alkalmazott\": {\n \"Uid\": \"000000\",\n \"Nev\": \"Xxxx Xxxxx\",\n \"Telefonok\": [],\n \"Emailek\": []\n }\n },\n \"Osztalyai\": [\n {\n \"Uid\": \"000000\",\n \"Nev\": \"Xxxx\"\n }\n ]\n },\n {...}\n ],\n \"Tutelaries\": [\n {\n \"TutelaryId\": 00000,\n \"Name\": \"Xxxxx\",\n \"Email\": \"xxxxxxxxxxxxxxxxxx\",\n \"PhoneNumber\": \"0000000000\"\n },\n\t\t{...}\n ]\n}"}],"_postman_id":"9d69acbb-b6fb-457c-9b18-6587597094cd"},{"name":"🔒 Felhasználó adatai - Régi","id":"cc799eb2-6100-49f9-b6a9-b5a982b5303a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer xxxxxxxxxxxxxx","equals":true,"description":"Bejelentkezés során kapott access_token
Lekéri a felhasználó adatait két dátum között vagy ezek hiánya esetén az összes adatot visszaadja.
\n","urlObject":{"path":["mapi","api","v1","Student"],"host":["https://XXXXXXXXXX.e-kreta.hu"],"query":[{"description":{"content":"Ha az értéke null vagy kihagyjuk ezt a paramétert, az összes a KRÉTA rendszerben lévő adatot visszakapjuk (tehát az egész évet)
\n","type":"text/plain"},"key":"fromDate","value":"2019-09-01"},{"description":{"content":"Ha az értéke null vagy kihagyjuk ezt a paramétert, az összes a KRÉTA rendszerben lévő adatot visszakapjuk (tehát az egész évet)
\n","type":"text/plain"},"key":"toDate","value":"2020-01-01"}],"variable":[]}},"response":[{"id":"0700282c-0f7d-4359-b260-24e060caaade","name":"Felhasználó adatainak lekérése","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer xxxxxxxxxxxxxx","equals":true,"description":"Bejelentkezés során kapott `access_token`"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"},{"key":"Accept","value":"application/json","type":"text"},{"key":"User-Agent","value":"Kreta.Ellenorzo/2.9.8.2020012301 (Android; XX-XXXX 0.0)","type":"text"}],"url":{"raw":"https://XXXXXXXXXX.e-kreta.hu/mapi/api/v1/Student","host":["https://XXXXXXXXXX.e-kreta.hu"],"path":["mapi","api","v1","Student"],"query":[{"key":"","value":"","type":"text"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Content-Length","value":"141638"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Expires","value":"-1"},{"key":"X-Robots-Tag","value":"noindex"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff "},{"key":"Strict-Transport-Security","value":"max-age=16070400; includeSubDomains"},{"key":"Content-Security-Policy","value":"default-src 'none' ;script-src 'self' 'unsafe-inline' 'unsafe-eval' https://js-agent.newrelic.com https://bam.nr-data.net https://www.googletagmanager.com https://www.google-analytics.com https://www.gstatic.com http://www.google.com; frame-src https://www.google.com/ https://idp.e-kreta.hu ; style-src 'self' 'unsafe-inline' https://fonts.googleapis.com; img-src * data: https:;connect-src 'self'; font-src 'self' https://fonts.googleapis.com https://fonts.gstatic.com; form-action 'self';"},{"key":"Date","value":"Thu, 13 Feb 2020 09:33:08 GMT"},{"key":"Set-Cookie","value":"TS013b0147=018aec130beb9ea9da47ebb1873363c83a92f5dda3825b40639a25c422c11d388de9e3523fd90607e3052392f9784873178ffd934c; Path=/; Domain=.e-kreta.hu"}],"cookie":[],"responseTime":null,"body":"{\n \"TanuloAktualisOktatasNevelesiKategoriaja\": \"Xxxxxx\",\n \"StudentId\": 0,\n \"SchoolYearId\": 0,\n \"Name\": \"Xxxxxx Xxxxx\",\n \"NameOfBirth\": \"Xxxxxx Xxxxx\",\n \"PlaceOfBirth\": \"Xxxxxxxxx\",\n \"MothersName\": \"Xxxxxx Xxxxx\",\n \"AddressDataList\": [\n \"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\",\n \"...\"\n ],\n \"DateOfBirthUtc\": \"2069-04-20T09:38:23\",\n \"InstituteName\": \"Xxxxxx Xxxxx\",\n \"InstituteCode\": \"Xxxxxxxxx\",\n \"Evaluations\": [\n {\n \"EvaluationId\": 0,\n \"Form\": \"Xxxx\",\n \"FormName\": \"Xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\",\n \"Type\": \"Xxxxxx\",\n \"TypeName\": \"Xxxxxx\",\n \"Subject\": \"Xxxxxx xxxxx\",\n \"SubjectCategory\": null,\n \"SubjectCategoryName\": \"Xxxxxx\",\n \"Theme\": \"Xxxxx\",\n \"IsAtlagbaBeleszamit\": true,\n \"Mode\": \"Xxxxxx\",\n \"Weight\": \"0%\",\n \"Value\": \"Xxxxxx\",\n \"NumberValue\": 0,\n \"SeenByTutelaryUTC\": null,\n \"Teacher\": \"Xxxxx Xxxxx\",\n \"Date\": \"2069-04-20T09:38:23\",\n \"CreatingTime\": \"2069-04-20T09:38:23\",\n \"Jelleg\": {\n \"Id\": 0,\n \"Nev\": \"Xxxxxx\",\n \"Leiras\": \"Xxxxxxx\"\n },\n \"JellegNev\": \"Xxxxxx\",\n \"ErtekFajta\": {\n \"Id\": 0,\n \"Nev\": \"Xxxxxxx\",\n \"Leiras\": \"XXxxxxxx\"\n },\n \"OsztalyCsoportUid\": \"000000\"\n },\n {...}\n ],\n \"SubjectAverages\": [\n {\n \"SubjectId\": 0,\n \"Subject\": \"Xxxxxxx\",\n \"SubjectCategory\": \"Xxxxxx\",\n \"SubjectCategoryName\": \"Xxxxxxx\",\n \"Value\": 0,\n \"ClassValue\": 0,\n \"Difference\": 0\n },\n {...}\n ],\n \"Absences\": [\n {\n \"AbsenceId\": 0,\n \"Type\": \"Xxxxxx\",\n \"TypeName\": \"Xxxxxx\",\n \"Mode\": \"Xxxxx\",\n \"ModeName\": \"Xxxxx xxxxxx\",\n \"Subject\": \"xxxxx\",\n \"SubjectCategory\": null,\n \"SubjectCategoryName\": \"Xxxxx\",\n \"DelayTimeMinutes\": 0,\n \"Teacher\": \"Xxxxxxx Xxxxxxx\",\n \"LessonStartTime\": \"2069-04-20T09:38:23\",\n \"NumberOfLessons\": 0,\n \"CreatingTime\": \"2069-04-20T09:38:23\",\n \"JustificationState\": \"Xxxxxxx\",\n \"JustificationStateName\": \"Xxxxxx xxxxx\",\n \"JustificationType\": \"Xxxxxxx\",\n \"JustificationTypeName\": \"Xxxxx xxxxx\",\n \"SeenByTutelaryUTC\": null,\n \"OsztalyCsoportUid\": \"000000\"\n },\n {...}\n ],\n \"Notes\": [\n {\n \"NoteId\": 0,\n \"Type\": \"Xxxxxxx\",\n \"Title\": \"Xxxxxxx\",\n \"Content\": \"Xxxxxx xxxxx xxxx xxxxxxxx xxx xxx\",\n \"SeenByTutelaryUTC\": null,\n \"Teacher\": \"Xxxxx Xxxx Xxxxx\",\n \"Date\": \"2069-04-20T09:38:23\",\n \"CreatingTime\": \"2069-04-20T09:38:23\",\n \"OsztalyCsoportUid\": \"000000\"\n },\n {...}\n ],\n \"OsztalyCsoportok\": [\n {\n \"OktatasNevelesiKategoria\": \"Xxxxxxxx\",\n \"Nev\": \"Xxx\",\n \"OsztalyCsoportTipus\": \"Xxxxx\",\n \"IsAktiv\": true,\n \"Uid\": \"000000\",\n \"OsztalyfonokUid\": \"000000\"\n },\n {...}\n ],\n \"Lessons\": null,\n \"Events\": null,\n \"FormTeacher\": {\n \"TeacherId\": 000000,\n \"Name\": \"Xxxx Xxxxx\",\n \"Email\": null,\n \"PhoneNumber\": null\n },\n \"Osztalyfonokok\": [\n {\n \"Uid\": \"000000\",\n \"Tanar\": {\n \"Uid\": \"000000\",\n \"Alkalmazott\": {\n \"Uid\": \"000000\",\n \"Nev\": \"Xxxx Xxxxx\",\n \"Telefonok\": [],\n \"Emailek\": []\n }\n },\n \"Osztalyai\": [\n {\n \"Uid\": \"000000\",\n \"Nev\": \"Xxxx\"\n }\n ]\n },\n {...}\n ],\n \"Tutelaries\": [\n {\n \"TutelaryId\": 00000,\n \"Name\": \"Xxxxx\",\n \"Email\": \"xxxxxxxxxxxxxxxxxx\",\n \"PhoneNumber\": \"0000000000\"\n },\n\t\t{...}\n ]\n}"}],"_postman_id":"cc799eb2-6100-49f9-b6a9-b5a982b5303a"},{"name":"🔒 Tanulmányi átlagok","id":"e09e4148-1ee2-42d5-8c98-a1222b818b55","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer xxxxxxxxxxxxxx","equals":true,"description":"Bejelentkezés során kapott access_token
Csak akkor használjuk, ha a .../StudentAmi API lekérdezéssel kaptuk meg a felhasználó adatait, ugyanis abból hiányoznak a tantárgyi átlagok.
Az órarend lekéréssel ellentétben itt fontos gyakorlati különbségek is vannak a .../Student és a .../StudentAmi API-k között:
.../Student elküldi a tanuló tanulmányi átlagait SubjectAverages-ként, ami a .../StudentAmi-nál null. Ahhoz, hogy ezesetben megkapjuk ezeket az adatokat, a .../TantargyiAtlagAmi lekérdezést kell használnunk (A hivatalos KRÉTA app is így csinálja). Érdekesség, hogy a .../TantargyiAtlagAmi visszaad egy plusz mezőt is, amit a .../Student nem csinált, ez a SortIndex.OsztalyCsoportok elrendezése eltér a két API-nak.../Student lekérdezésben még szerepelt a TanuloAktualisOktatasNevelesiKategoriaja, ezt kivették, a .../StudentAmi nem tartalmazzaA különbségeket a .../LessonAmi példájában kommentekkel is megjelöltem. Az API-k ugyanolyan adatokat várnak, a válaszidejük hasonló. Az Arisztokréta alkalmazás jelenleg a .../Student lekérdezést használja, mert szerintem felesleges még egy külön lekérdezéssel lassítani az appot.
A KRÉTA egyébként említi az AMI modult a tudásbázisában:
\n\n\nAz AMI-k számára kifejlesztett, az Összetett intézményekben többes jogviszonyt, több osztályba tartozást lehetővé tevő modul bekapcsolásához mind a tiszta AMI, mind az Összetett intézmény számára szükséges, hogy a Nyilvántartás / Intézmény menüpontban beállításra kerüljön Alapfokú művészetoktatás vagy Művészeti szakgimnázium ellátott köznevelési feladat.
\n
Forrás és további információ: https://tudasbazis.ekreta.hu/pages/viewpage.action?pageId=33325156
\n","_postman_id":"721879b3-d61e-4acc-b319-16e6c8b66f73"},{"name":"Bejelentett számonkérések","item":[{"name":"🔒 Bejelentett számonkérések - Új (AMI)","id":"55a5e35a-5d79-42bc-95e5-952cc2c73496","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer xxxxxxxxxxxxxx","equals":true,"description":"Bejelentkezés során kapott access_token
Lekéri a bejelentett számonkérések listáját
\n","urlObject":{"path":["mapi","api","v1","BejelentettSzamonkeresAmi"],"host":["https://XXXXXXXXXX.e-kreta.hu"],"query":[{"description":{"content":"Ha az értéke null vagy kihagyjuk ezt a paramétert, az összes a KRÉTA rendszerben lévő adatot visszakapjuk (tehát az egész évet)
\n","type":"text/plain"},"key":"fromDate","value":"2019-09-01"},{"description":{"content":"Ha az értéke null vagy kihagyjuk ezt a paramétert, az összes a KRÉTA rendszerben lévő adatot visszakapjuk (tehát az egész évet)
\n","type":"text/plain"},"key":"toDate","value":"2020-01-01"}],"variable":[]}},"response":[{"id":"bfdd4a30-26d3-41a7-992e-1fd104816b9e","name":"Bejelentett számonkérések","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer xxxxxxxxxxxxxx","equals":true,"description":"Bejelentkezés során kapott `access_token`"},{"key":"Accept","value":"application/json","type":"text"},{"key":"User-Agent","value":"Kreta.Ellenorzo/2.9.8.2020012301 (Android; XX-XXXX 0.0)","type":"text"}],"url":{"raw":"https://XXXXXXXXXX.e-kreta.hu/mapi/api/v1/BejelentettSzamonkeresAmi?fromDate=2019-09-01&toDate=2020-01-01","host":["https://XXXXXXXXXX.e-kreta.hu"],"path":["mapi","api","v1","BejelentettSzamonkeresAmi"],"query":[{"key":"fromDate","value":"2019-09-01"},{"key":"toDate","value":"2020-01-01"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Content-Length","value":"1559"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Expires","value":"-1"},{"key":"X-Robots-Tag","value":"noindex"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff "},{"key":"Strict-Transport-Security","value":"max-age=16070400; includeSubDomains"},{"key":"Content-Security-Policy","value":"default-src 'none' ;script-src 'self' 'unsafe-inline' 'unsafe-eval' https://js-agent.newrelic.com https://bam.nr-data.net https://www.googletagmanager.com https://www.google-analytics.com https://www.gstatic.com http://www.google.com; frame-src https://www.google.com/ https://idp.e-kreta.hu ; style-src 'self' 'unsafe-inline' https://fonts.googleapis.com; img-src * data: https:;connect-src 'self'; font-src 'self' https://fonts.googleapis.com https://fonts.gstatic.com; form-action 'self';"},{"key":"Date","value":"Thu, 13 Feb 2020 10:07:05 GMT"},{"key":"Set-Cookie","value":"TS019cd799=018aec130bb17a7ccdfb174d956cf03f7d239b420a015787796bc7bb08dd02f2c09f5b14ba9a7211aee5ea097b4df4a0c2d572c30d; Path=/; Domain=.e-kreta.hu"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"Uid\": \"000\",\n \"Id\": 000,\n \"Datum\": \"2069-04-20T00:00:00Z\",\n \"HetNapja\": \"Xxxxx\",\n \"Oraszam\": 0,\n \"Tantargy\": \"xxxxxxx xxxx\",\n \"Tanar\": \"Xxxxxx Xxxxx\",\n \"SzamonkeresMegnevezese\": \"Xxxxxx xxxxxx xxx\",\n \"SzamonkeresModja\": \"Xxxxxxx\",\n \"BejelentesDatuma\": \"2069-04-20T00:00:00Z\",\n \"OsztalyCsoportUid\": \"000000\"\n },\n {...}\n]"}],"_postman_id":"55a5e35a-5d79-42bc-95e5-952cc2c73496"},{"name":"🔒 Bejelentett számonkérések - Régi","id":"a05b5df6-3308-41ae-8e8b-9d8a08edb27c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer xxxxxxxxxxxxxx","equals":true,"description":"Bejelentkezés során kapott access_token
Lekéri a bejelentett számonkérések listáját
\n","urlObject":{"path":["mapi","api","v1","BejelentettSzamonkeres"],"host":["https://XXXXXXXXXX.e-kreta.hu"],"query":[{"description":{"content":"Ha az értéke null vagy kihagyjuk ezt a paramétert, az összes a KRÉTA rendszerben lévő adatot visszakapjuk (tehát az egész évet)
\n","type":"text/plain"},"key":"fromDate","value":"2019-09-01"},{"description":{"content":"Ha az értéke null vagy kihagyjuk ezt a paramétert, az összes a KRÉTA rendszerben lévő adatot visszakapjuk (tehát az egész évet)
\n","type":"text/plain"},"key":"toDate","value":"2020-01-01"}],"variable":[]}},"response":[{"id":"c28f03a8-57c1-4a4b-9443-7129abc3de12","name":"Bejelentett számonkérések - Régi","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer xxxxxxxxxxxxxx","equals":true,"description":"Bejelentkezés során kapott `access_token`"},{"key":"Accept","type":"text","value":"application/json"},{"key":"User-Agent","type":"text","value":"Kreta.Ellenorzo/2.9.8.2020012301 (Android; XX-XXXX 0.0)"}],"url":{"raw":"https://XXXXXXXXXX.e-kreta.hu/mapi/api/v1/BejelentettSzamonkeres?fromDate=2019-09-01&toDate=2020-01-01","host":["https://XXXXXXXXXX.e-kreta.hu"],"path":["mapi","api","v1","BejelentettSzamonkeres"],"query":[{"key":"fromDate","value":"2019-09-01"},{"key":"toDate","value":"2020-01-01"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Content-Length","value":"1559"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Expires","value":"-1"},{"key":"X-Robots-Tag","value":"noindex"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff "},{"key":"Strict-Transport-Security","value":"max-age=16070400; includeSubDomains"},{"key":"Content-Security-Policy","value":"default-src 'none' ;script-src 'self' 'unsafe-inline' 'unsafe-eval' https://js-agent.newrelic.com https://bam.nr-data.net https://www.googletagmanager.com https://www.google-analytics.com https://www.gstatic.com http://www.google.com; frame-src https://www.google.com/ https://idp.e-kreta.hu ; style-src 'self' 'unsafe-inline' https://fonts.googleapis.com; img-src * data: https:;connect-src 'self'; font-src 'self' https://fonts.googleapis.com https://fonts.gstatic.com; form-action 'self';"},{"key":"Date","value":"Thu, 13 Feb 2020 13:53:24 GMT"},{"key":"Set-Cookie","value":"TS019cd799=018aec130b085bb57c79f7e772cde9c7d3657810926c14bec9b968f72f290c9522f28c75edf8887242b2b0013e58c578accfc1ba4c; Path=/; Domain=.e-kreta.hu"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"Uid\": \"000\",\n \"Id\": 000,\n \"Datum\": \"2069-04-20T00:00:00Z\",\n \"HetNapja\": \"Xxxxx\",\n \"Oraszam\": 0,\n \"Tantargy\": \"xxxxxxx xxxx\",\n \"Tanar\": \"Xxxxxx Xxxxx\",\n \"SzamonkeresMegnevezese\": \"Xxxxxx xxxxxx xxx\",\n \"SzamonkeresModja\": \"Xxxxxxx\",\n \"BejelentesDatuma\": \"2069-04-20T00:00:00Z\",\n \"OsztalyCsoportUid\": \"000000\"\n }\n]"}],"_postman_id":"a05b5df6-3308-41ae-8e8b-9d8a08edb27c"}],"id":"697954fc-1e6a-4217-895a-2c1b9cf5e0da","description":"A Bejelentett Számonkérések lekérésére is két API áll rendelkezésre és hasonlóan az órarendhez, mindkettő pontosan ugyanazt csinálja és pontosan ugyanúgy működik, a válaszidőben, a visszakapott adatokban nincs különbség. A hivatalos KRÉTA alkalmazás régebben a .../BejelentettSzamonkeres API-t használta, azonban jelenleg már a .../BejelentettSzamonkeresAmi-t. Valószínű, hogy az előbbit le akarják selejtezni, ezért azt javaslom, hogy mindenki a .../BejelentettSzamonkeresAmi-t használja.
A KRÉTA egyébként említi az AMI modult a tudásbázisában:
\n\n\nAz AMI-k számára kifejlesztett, az Összetett intézményekben többes jogviszonyt, több osztályba tartozást lehetővé tevő modul bekapcsolásához mind a tiszta AMI, mind az Összetett intézmény számára szükséges, hogy a Nyilvántartás / Intézmény menüpontban beállításra kerüljön Alapfokú művészetoktatás vagy Művészeti szakgimnázium ellátott köznevelési feladat.
\n
Forrás és további információ: https://tudasbazis.ekreta.hu/pages/viewpage.action?pageId=33325156
\n","_postman_id":"697954fc-1e6a-4217-895a-2c1b9cf5e0da"},{"name":"E-üzenetek","item":[{"name":"🔒 E-üzenet lista lekérése","id":"0c9ba0bc-bb5b-46e3-b4e7-b23b96fcba16","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer xxxxxxxxxxxxxx","type":"text"},{"key":"User-Agent","value":"Kreta.Ellenorzo/2.9.8.2020012301 (Android; XX-XXXX 0.0)","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"url":"https://eugyintezes.e-kreta.hu/integration-kretamobile-api/v1/kommunikacio/postaladaelemek/sajat","description":"Lekéri a felhasználó beérkezett üzeneteinek listáját. Az így kapott Message.uzenet.szoveg azonban csak a szöveg első 100 karaktere, hogy a teljes tartalmat lekérjük, másik lekérdezést kell használni.
Lekéri egy e-üzenet összes adatát, beleértve a szöveg teljes hosszát, nem csak az első 100 karaktert.
\nSzükséges adat:
\nMessage.azonosito - Ezt az e-üzenet lista lekéréssel kapott üzenet azonosito-jaAz E-üzenetek lekérése egy API segítségével működik azonban kétféleképpen kell használnunk, ahhoz, hogy minden adatot megkapjunk.
\n.../postaladaelemek/sajat API-ra ha nem küldünk paraméterként egy Message.azonosito-t, akkor visszakapjuk a felhasználó beérkezett üzeneteinek listáját, azonban a Message.uzenet.szoveg első 100 karakterét kapjuk csak vissza.\n\nTIPP: Ezt a hivatalos KRÉTA alkalmazás arra használja, hogy kiírja az üzenetek listájánál a szöveg elejét abból a célból, hogy a felhasználó tudja, miről szól az adott e-üzenet, anélkül, hogy azt megnyitná
\n
.../postaladaelemek/sajat/ API-ra ha elküldjük az üzenetek listája lekérés során kapott Message.azonosito-t, visszakapjuk ugyanazokat az adatokat, azzal a különbséggel, hogy a teljes szöveg átjön, nem csak az első 100 karakter.Bejelentkezés során kapott access_token
Lekéri az órához tartozó Tanuló által feladott házi feladatok listáját.
\nSzükséges adat:
\nLesson.TeacherHomeworkId - Az órarend lekérése során kapott óra TeacherHomeworkId-je. (Érdekes, hogy a Tanuló házi feladat lekéréséhez is ezt kell használni)Bejelentkezés során kapott access_token
Lekéri az órához tartozó Tanár által feladott házi feladatot.
\nSzükséges adat:
\nLesson.TeacherHomeworkId - Az órarend lekérése során kapott óra TeacherHomeworkId-je.A KRÉTA API rendszere valamilyen célból teljesen külön API-t használ a Tanuló által és a Tanár által feladott házi feladatokra.
\n![adatlapján](\"https://github.com/Coware-Apps/ellenorzo/blob/master/docs/documentation_assets/teacherHomework.jpg\"){kind=link}
IsTanuloHaziFeladatEnabled mezője true)\n\n","_postman_id":"e23b098a-e111-4c4b-86dc-0c8892e0b4b6"}],"id":"c88ec411-f90a-4e1a-a08b-738307975238","description":"Tipp: Alkalmazás fejlesztésnél célszerű lekérni az órarendet és megjeleníteni mellette egy kis házikó ikont, ha a **
\nTeacherHomeworkId-je nemnull. Ez azt jelenti, hogy az órához vagy Tanári vagy Tanuló házi feladat tartozik**. A.../TanarHaziFeladatés a.../TanuloHaziFeladatListaAPI-ról csak akkor kérjük le a tartalmát, ha a felhasználó rákattint erre az ikonra. Ez azért fontos, mert nagyon lassú lenne az alkalmazás ha az órarend betöltésekor minden óra minden Házi Feladatát lekérnénk.
Ide tartozik minden olyan request amit a hivatalos és nem hivatalos KRÉTA alkalmazások adatok megjelenítéséhez használnak.
\n","_postman_id":"c88ec411-f90a-4e1a-a08b-738307975238"},{"name":"Adatok szerkesztése","item":[{"name":"🔒 Tanuló házi feladat hozzáadása","id":"6c8f9207-6742-44b7-ad33-49e77811f22b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer xxxxxxxxxxxxxx","equals":true,"description":"Bejelentkezés során kapott access_token
Hozzáad az OraId-hez tartozó órához egy Tanuló házi feladatot
Az órarend lekérdezésből kapott óra LessonId-je
Az órarend lekérdezésből kapott óra StartTime mezője
Az órarend lekérdezésből kapott óra CalendarOraType mezője
A hivatalos KRÉTA app mindig az adott hét vasárnapján, 23:00-t állít be (UTC formátumban)
\n","type":"text/plain"},"key":"HataridoUtc","value":"2069-04-20T23:00:00"},{"description":{"content":"A tanuló által megadott feladat szövege
\n","type":"text/plain"},"key":"FeladatSzovege","value":"Xxxxxxxxxxxxxxxxx"}],"variable":[]}},"response":[{"id":"cd4a3d2f-47ac-4222-b531-697f445ead7e","name":"Tanuló házi feladat","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer xxxxxxxxxxxxxx","equals":true,"description":"Bejelentkezés során kapott `access_token`"},{"key":"Content-Type","value":"application/json; charset=utf-8","type":"text"},{"key":"User-Agent","value":"Kreta.Ellenorzo/2.9.8.2020012301 (Android; XX-XXXX 0.0)","type":"text"}],"url":{"raw":"https://XXXXXXXXXX.e-kreta.hu/mapi/api/v1/HaziFeladat/CreateTanuloHaziFeladat?OraId=000000&OraDate=2069-04-20T00:00:00&OraType=Xxxxxxxx&HataridoUtc=2069-04-20T23:00:00&FeladatSzovege=Xxxxxxxxxxxxxxxxx","host":["https://XXXXXXXXXX.e-kreta.hu"],"path":["mapi","api","v1","HaziFeladat","CreateTanuloHaziFeladat"],"query":[{"key":"OraId","value":"000000","description":"Az órarend lekérdezésből kapott óra LessonId-je"},{"key":"OraDate","value":"2069-04-20T00:00:00","description":"Az órarend lekérdezésből kapott óra StartTime mezője"},{"key":"OraType","value":"Xxxxxxxx","description":"Az órarend lekérdezésből kapott óra CalendarOraType mezője"},{"key":"HataridoUtc","value":"2069-04-20T23:00:00","description":"A hivatalos KRÉTA app mindig az adott hét vasárnapján, 23:00-t állít be (UTC formátumban)"},{"key":"FeladatSzovege","value":"Xxxxxxxxxxxxxxxxx","description":"A tanuló által megadott feladat szövege"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"TanarHaziFeladatId\": 00000,\n \"HozzaadottTanuloHaziFeladatId\": 000,\n \"HozzaadottTanuloHaziBejelentesDatuma\": \"2069-04-20T09:38:23\"\n}"}],"_postman_id":"6c8f9207-6742-44b7-ad33-49e77811f22b"},{"name":"🔒 Tanuló házi feladat törlése","id":"8ad72768-bf39-43ec-82f5-c34710d22e01","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"Authorization","value":"Bearer xxxxxxxxxxxxxx","equals":true,"description":"Bejelentkezés során kapott access_token
Töröl egy tanuló által hozzáadott Házi Feladatot.\nSzükséges adat:
\nHomework.id - A tanuló házi feladat lista során lekért házi feladat id-jeOlvasottnak jelöl egy e-üzenetet.\nSzükséges adat:
\nMessage.uzenet.azonosito - Az üzenetek listája lekérése során kapott üzenet uzenet.azonosito-ja\n\n","urlObject":{"protocol":"https","path":["integration-kretamobile-api","v1","kommunikacio","uzenetek","olvasott"],"host":["eugyintezes","e-kreta","hu"],"query":[],"variable":[]}},"response":[{"id":"717ca78b-b102-4ebe-8f6d-5599f5a3ccde","name":"🔒 E-üzenet olvasottnak jelölése","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer xxxxxxxxxxxxxx","type":"text"},{"key":"User-Agent","value":"Kreta.Ellenorzo/2.9.8.2020012301 (Android; XX-XXXX 0.0)","type":"text"},{"key":"Accept","value":"application/json","type":"text"},{"key":"Accept-Encoding","value":"gzip","type":"text"},{"key":"Content-type","value":"application/json; charset=utf-8","type":"text"}],"body":{"mode":"raw","raw":"{\n\t\"isOlvasott\": true,\n\t\"uzenetAzonositoLista\": [000000]\n}"},"url":"https://eugyintezes.e-kreta.hu/integration-kretamobile-api/v1/kommunikacio/uzenetek/olvasott"},"status":"No Content","code":204,"_postman_previewlanguage":"plain","header":[{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"-1"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"Strict-Transport-Security","value":"max-age=16070400; includeSubDomains"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Content-Security-Policy","value":"default-src 'none'; font-src https://fonts.googleapis.com/ https://fonts.gstatic.com/ 'self'; img-src 'self' data: www.google-analytics.com; script-src 'self' 'unsafe-eval' 'unsafe-inline' www.google-analytics.com; style-src https://fonts.googleapis.com/ https://fonts.gstatic.com/ 'self' 'unsafe-inline' ; connect-src *; frame-src *;"},{"key":"Referrer-Policy","value":"strict-origin"},{"key":"Date","value":"Sun, 16 Feb 2020 13:44:35 GMT"}],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"a41e5c97-cd2d-4aea-8e0c-1f5df6655c7b"}],"id":"ee8c59ee-6857-447d-ae21-2a7e636687e8","description":"Érdekesség, hogy ha az isOlvasott-at false-ra állítjuk és úgy küldjük el a request-et, akkor képesek vagyunk olvasatlan-ra állítani az üzenetet. Ennek gyakorlati haszna nagyon nincs de fejlesztéskor hasznos tud lenni.
\n
Az órarend bármely órájához hozzáadhatunk házi feladatot, vagy a már hozzáadott tanuló házi feladatok közül bármelyiket törölhetjük, ha az adott órának az IsTanuloHaziFeladatEnabled mezője true. Ez intézmény szinten változik, a tanárok vagy a rendszergazda rendelkezik rendszerint hozzáféréssel ennek a beállításnak a módosításához.