Notice: I no longer have access to a Kreta account. As such, I am looking for a maintainer to take over this project and allow it to remain up to date. Email me for details!
Updated documentation for version 3 of the e-kreta API.
Most of the info here is based on Filc's source code and boapps' v1 documentation, while the rest was hand tested.
The repository also contains a Python program to access most functions, and as a sort of example of usage.
- Filc: An unnofficial e-diary application for the e-Kreta system.
- Asztal: Terminal-based e-Kreta client.
- kreta-cli: A command line interface for KRÉTA's latest v3 api
- Táblafilc: A grade calculator program for students (GitHub).
To add your project to the list, create a pull request with it added.
5. Messages
9. Other
taken from Filc's source
class Kreta:
def base(ist):
return f"https://{ist}.e-kreta.hu"
IDP = "https://idp.e-kreta.hu"
ADMIN = "https://eugyintezes.e-kreta.hu"
FILES = "https://files.e-kreta.hu"
class KretaEndpoints:
token = "/connect/token"
nonce = "/nonce"
notes = "/ellenorzo/V3/Sajat/Feljegyzesek"
events = "/ellenorzo/V3/Sajat/FaliujsagElemek"
student = "/ellenorzo/V3/Sajat/TanuloAdatlap"
grades = "/ellenorzo/V3/Sajat/Ertekelesek"
absences = "/ellenorzo/V3/Sajat/Mulasztasok"
groups = "/ellenorzo/V3/Sajat/OsztalyCsoportok"
groupAverages = "/ellenorzo/V3/Sajat/Ertekelesek/Atlagok/OsztalyAtlagok"
timetable = "/ellenorzo/V3/Sajat/OrarendElemek"
exams = "/ellenorzo/V3/Sajat/BejelentettSzamonkeresek"
homework = "/ellenorzo/V3/Sajat/HaziFeladatok"
capabilities = "/ellenorzo/V3/Sajat/Intezmenyek"
class AdminEndpoints:
sendMessage = "/api/v1/kommunikacio/uzenetek"
def getAllMessages(endpoint):
return f"/api/v1/kommunikacio/postaladaelemek/{endpoint}"
def getMessage(id):
return f"/api/v1/kommunikacio/postaladaelemek/{id}"
recipientCategories = "/api/v1/adatszotarak/cimzetttipusok"
availableCategories = "/api/v1/kommunikacio/cimezhetotipusok"
recipientsTeacher = "/api/v1/kreta/alkalmazottak/tanar"
uploadAttachment = "/ideiglenesfajlok"
def downloadAttachment(id):
return "/v1/dokumentumok/uzenetek/$id"
trashMessage = "/api/v1/kommunikacio/postaladaelemek/kuka"
deleteMessage = "/api/v1/kommunikacio/postaladaelemek/torles"Useful so that if the api links change you don't have to update your app.
(found by thegergo02)
Response from server:
{
"GlobalMobileApiUrlDEV": "https://kretaglobalmobileapidev.ekreta.hu/",
"GlobalMobileApiUrlTEST": "https://kretaglobalmobileapitest.ekreta.hu",
"GlobalMobileApiUrlUAT": "https://kretaglobalmobileapiuat.ekreta.hu",
"GlobalMobileApiUrlPROD": "https://kretaglobalmobileapi2.ekreta.hu"
}Technically it is available from a normal browser as well.
May not work in languages with no lowercase header request, like Swift and Dart, see BoA's note.
curl "https://kretaglobalmobileapi2.ekreta.hu/api/v3/Institute" -H "apiKey: 7856d350-1fda-45f5-822d-e1a2f3f1acf0"Response from server
[
{
"instituteId": 0000,
"instituteCode": "xxxxxxxxxxx",
"name": "Xxxxx Xxxx Xxxxxx",
"city": "Xxxxxx",
"url": "https://xxxxxxxxxxx.e-kreta.hu",
"advertisingUrl": "",
"informationImageUrl": "https://kretamobile.blob.core.windows.net/advertisement/nati_app.gif",
"informationUrl": "",
"featureToggleSet": {}
},
...
]Returns a Bearer authenticator to be used later for most requests.
NOTE: Sometimes it seems to return a 502 error, not sure why or if it's a problem I can fix.
NOTE: To simplify the X-AuthorizationPolicy-Key and X-AuthorizationPolicy-Nonce header information, please refer to the kreta_v2.py file.
curl "https://idp.e-kreta.hu/connect/token" -A "hu.ekreta.tanulo/1.0.5/Android/0/0" -H "X-AuthorizationPolicy-Key: xxx" -H "X-AuthorizationPolicy-Version: v2" -H "X-AuthorizationPolicy-Nonce: xxx" -d "userName=xxxxxxxx&password=xxxxxxxxx&institute_code=xxxxxxxxx&grant_type=password&client_id=kreta-ellenorzo-mobile-android"Response from server:
{
"access_token":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"refresh_token": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
...
}With grant_type=refresh_token you can then refresh your access token:
curl "https://idp.e-kreta.hu/connect/token" -A "hu.ekreta.tanulo/1.0.5/Android/0/0" -d "institute_code=xxxxxxxxx&refresh_token=xxxxxxxxxxxx&grant_type=refresh_token&client_id=kreta-ellenorzo-mobile-android"Requires the same headers as all GET requests, but also needs an endpoint that can be beerkezett, elkuldott or torolt.
curl "https://eugyintezes.e-kreta.hu/api/v1/kommunikacio/postaladaelemek/$type" -A "hu.ekreta.tanulo/1.0.5/Android/0/0" -H "Authorization: Bearer xxxxxxxx"Response from server:
[
{
"azonosito": 0000000,
"uzenetAzonosito": 000000,
"uzenetKuldesDatum":"1970-01-01T00:00:00",
"uzenetFeladoNev":"Xxxxx Xxxxx",
"uzenetFeladoTitulus":"xxxxxxxxxx",
"uzenetTargy":"xxxxxxxxx",
"hasCsatolmany":false,
"isElolvasva":true
},
...
]The above method is limited in message length (I think to 100 characters), so this gets more info about a specific messages denoted by it's numeric id.
curl "https://eugyintezes.e-kreta.hu/api/v1/kommunkacio/postaladaelemek/$ID" -A "hu.ekreta.tanulo/1.0.5/Android/0/0" -H "Authorization: Bearer xxxxxxxx"cimzettListacan have either a student or a class value (as far as I can tell).
Response from server:
{
"azonosito": 0000000,
"isElolvasva":true,
"isToroltElem":false,
"tipus": {
"azonosito":1,
"kod":"BEERKEZETT",
"rovidNev":"Beérkezett üzenet",
"nev":"Beérkezett üzenet",
"leiras":"Beérkezett üzenet"
},
"uzenet": {
"azonosito":0000000,
"kuldesDatum": "1970-01-01T00:00:00",
"feladoNev":"Dudás Attila",
"feladoTitulus":"igazgató h.",
"szoveg":"...",
"targy":" Tájékoztató ",
"statusz": {
"azonosito":2,
"kod":"KIKULDVE",
"rovidNev": "Kiküldve",
"nev":"Kiküldve",
"leiras":"Kiküldve"
},
"cimzettLista":
[
{
"azonosito": 0000000,
"kretaAzonosito": 00000,
"nev":"9.A",
"tipus": {
"azonosito":4,
"kod":"OSZTALY_TANULO",
"rovidNev":"Osztály - Tanuló",
"nev":"Osztály - Tanuló",
"leiras":"Osztály - Tanuló"
}
},
{
"azonosito":0000000,
"kretaAzonosito": 000000,
"nev": "Xxxxxxx Xxxxxxx",
"tipus": {
"azonosito":9,
"kod":"TANAR",
"rovidNev":"Tanár",
"nev":"Tanár",
"leiras":"Tanár"
}
},
...
],
"csatolmanyok": [
{
"azonosito": 0000000,
"fajlNev": "xxxxxxx.xxx"
},
...
]
}
}not sure yet
curl "https://"$ist".e-kreta.hu/ellenorzo/V3/Sajat/BejelentettSzamonkeresek?datumTol=null" -A "hu.ekreta.tanulo/1.0.5/Android/0/0" -H "Authorization: Bearer xxxxxxxx"datumTolis an optional parameter, without it the server returns all.- I only have
irasbeli_temazaro_dolgozatas a type, but logically there should be stuff likeszobeli_felelesand others.
Response from server:
[
{
"BejelentesDatuma": "1970-01T00:00:00Z",
"Datum": "2019-10-08T22:00:00Z",
"Modja": {
"Uid": "0000,irasbeli_temazaro_dolgozat",
"Leiras": "Írásbeli témazáró dolgozat",
"Nev": "irasbeli_temazaro_dolgozat"
},
"OrarendiOraOraszama": 1,
"RogzitoTanarNeve": "Kókai Mária",
"TantargyNeve": "Mathematics",
"Temaja": "Combinatorics and graphs",
"OsztalyCsoport": {
"Uid": "88429"
},
"Uid": "784"
},
]Used to be together with absences & evaluations, but has it since been separated with v2.
curl "https://"$institute".e-kreta.hu/ellenorzo/V3/Sajat/TanuloAdatlap" -A "hu.ekreta.tanulo/1.0.5/Android/0/0" -H "Authorization: Bearer xxxxxxxx""SzuletesiDatum"represents 00:00 of the given date, but is in UTC time:YYYY-MM-(DD-1)T23:00:00Z."TestreszabhatoBeallitasok"shows if the school allows things like student-submitted homeworks, showing themes of lessons, displaying class averages or even a global delay in evaluations showing up for whatever reason.
Response from server
{
"AnyjaNeve": "Xxxxxx Xxxxxx",
"Cimek": [
"City (Postcode), Street Number",
"Xxxx (0000), Xxxxxx street 0"
],
"Gondviselok": [
{
"EmailCim": "[email protected]",
"Nev": "Xxxxxxx Xxxxxx",
"Telefonszam": "+xxxxxxxxxxx",
"IsTorvenyesKepviselo": true,
"Uid": "xxxxx"
}
],
"IntezmenyAzonosito": "xxxxxxxxxx",
"IntezmenyNev": "Xxxxxxxxxx Xxxxxxxxx",
"Nev": "Xxxxx Xxxxx Xxxxx",
"SzuletesiDatum": "2002-12-02T23:00:00Z",
"SzuletesiEv": 2002,
"SzuletesiHonap": 12,
"SzuletesiNap": 02,
"SzuletesiHely": "Xxxxxxx XX Xxxxx",
"SzuletesiNev": "Xxxxx Xxxxx Xxxxx",
"TanevUid": "0000",
"Uid": "000000",
"Bankszamla": {
"BankszamlaSzam": null,
"BankszamlaTulajdonosTipusId": null,
"BankszamlaTulajdonosNeve": null,
"IsReadOnly": false
},
"Intezmeny": {
"Uid": "0000",
"RovidNev": "xxxxxxxxxx",
"Rendszermodulok": [
{
"IsAktiv": true,
"Tipus": "Eugyintezes"
}
],
"TestreszabasBeallitasok": {
"IsDiakRogzithetHaziFeladatot": false,
"IsTanorakTemajaMegtekinthetoEllenorzoben": true,
"IsOsztalyAtlagMegjeleniteseEllenorzoben": false,
"ErtekelesekMegjelenitesenekKesleltetesenekMerteke": 0,
"KovetkezoTelepitesDatuma": "2021-05-04T19:00:00Z"
}
}
}$endpoint refers to the data requested: Ertekelesek/Mulasztasok/OrarendElemek.
datumTol & datumIg is required for timetable, while optional for the other two.
curl "https://"$institute".e-kreta.hu/ellenorzo/V3/Sajat/"$endpoint"?datumTol=2020-09-01T00-00-00&datumIg=2020-09-08T00-00-00" -A "hu.ekreta.tanulo/1.0.5/Android/0/0" -H "Authorization: Bearer xxxxxxxx"[
{
"ErtekeloTanarNeve": "Xxxxx Xxxxx",
"ErtekFajta": {
"Uid": "0,Osztalyzat",
"Leiras": "Elégtelen (1) és Jeles (5) között az öt alapértelmezett érték",
"Nev": "Osztalyzat"
},
"Jelleg": "Ertekeles",
"KeszitesDatuma": "1970-01-01T00:00:00Z",
"LattamozasDatuma": null,
"Mod": {
"Uid": "0000,type_of_eval",
"Leiras": "Type of Eval",
"Nev": "type_of_eval"
},
"RogzitesDatuma": "1970-01-01T00:00:00Z",
"SulySzazalekErteke": 100,
"SzamErtek": 0,
"SzovegesErtek": "Szöveg(0)",
"SzovegesErtekelesRovidNev": null,
"Tantargy": {
"Uid": "000000",
"Kategoria": {
"Uid": "0000,subject",
"Leiras": "Subject",
"Nev": "subject"
},
"Nev": "Subject"
},
"Tema": "...",
"Tipus": {
"Uid": "0000,evkozi_jegy_ertekeles",
"Leiras": "Évközi jegy/értékelés",
"Nev": "evkozi_jegy_ertekeles"
},
"OsztalyCsoport": {
"Uid": "00000"
},
"Uid": "00000000,Ertekeles"
},
...
]type_of_evalseems to have the same values possible as Pre-AnnouncedLeiraslooks to be the way to differentiate mid/half/endyear gradesSulySzazalekErtekeis usually 100/200, but I've seen end of term grades registered at 150 so it's better to code it flexibly.
[
{
"IgazolasAllapota": "Igazolt",
"IgazolasTipusa": {
"Uid": "0000,szuloi_igazolas",
"Leiras": "Szülői igazolás",
"Nev": "szuloi_igazolas"
},
"KesesPercben": null,
"KeszitesDatuma": "1970-01-01T00:00:00Z",
"Mod": {
"Uid": "1,Tanorai",
"Leiras": "Tanórai mulasztás",
"Nev": "Tanorai"
},
"Datum": "1970-01-01T00:00:00Z",
"Ora": {
"KezdoDatum": "1970-01-01T08:30:00Z",
"VegDatum": "2020-09-01T00:00:00Z",
"Oraszam": 5
},
"RogzitoTanarNeve": "Xxxxx Xxxxx",
"Tantargy": {
"Uid": "000000",
"Kategoria": {
"Uid": "0000,subject_name",
"Leiras": "Subject Name",
"Nev": "subject_name"
},
"Nev": "subject name"
},
"Tipus": {
"Uid": "0000,hianyzas",
"Leiras": "Hiányzás",
"Nev": "hianyzas"
},
"OsztalyCsoport": {
"Uid": "00000"
},
"Uid": "00000000"
},
...
] Oraszamrefers to the index of the lesson starting from 1.Leirasagain likely has a multitude of possible values that I cannot test.
[
{
"Allapot": {
"Uid": "1,Naplozott",
"Leiras": "Naplózott",
"Nev": "Naplozott"
},
"BejelentettSzamonkeresUids": [],
"BejelentettSzamonkeresUid": null,
"Datum": "1970-01-01T00:00:00Z",
"HelyettesTanarNeve": null,
"IsTanuloHaziFeladatEnabled": false,
"KezdetIdopont": "1970-01-01T00:00:00Z",
"Nev": "xxxxxxx",
"Oraszam": 0,
"OraEvesSorszama": 0,
"OsztalyCsoport": {
"Uid": "000000",
"Nev": "xxx xxx xxx"
},
"HaziFeladatUid": null,
"IsHaziFeladatMegoldva": false,
"TanarNeve": "Xxxxx Xxxxxx",
"Tantargy": {
"Uid": "000000",
"Kategoria": {
"Uid": "0000,xxxx_xxxx",
"Leiras": "Xxxxx Xxxx",
"Nev": "xxxx_xxxx"
},
"Nev": "Spanish"
},
"TanuloJelenlet": {
"Uid": "0000,Xxxxx",
"Leiras": "...",
"Nev": "Xxxx"
},
"Tema": "...",
"TeremNeve": "xxx",
"Tipus": {
"Uid": "0,XxxxxXxxx",
"Leiras": "Xxxx Xxxx",
"Nev": "XxxxxXxxx"
},
"Uid": "0000000,Xxxxxxxx,1970-01-01T00:00:00Z",
"VegIdopont": "1970-01-01T00:15:00Z"
},
...
]I've only listed and examplified what I think is probably the most used parts, or ones with peculiarities.
Everything else listed in the classes that's not mentioned should follow the same header format as seen above.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent