MER központi törzsadat karbantartó rendszerben tárolt, illetve onnan származó adatok:
MER kommunikációs interface-en keresztül az állásközvetítő szoftveréből származó adatok:
Alapvető integrációs sajátosságok és elvárások:
Az állásközvetítőknél működő kereskedelmi szoftverek az aktuális és lejárt státuszú állásokat tartja nyilván. A MER központi törzsadat és karbantartó rendszer ezeket az adatokat negyedéves időszakban fogadja.
API Specifikáció:
A kommunikációs szolgáltatást egy API technológián alapuló szerviz valósítja meg. Az API-n keresztüli kommunikációt a MER állásközvetítők profilkezelésében található API kulccsal valósítható meg.
Az API kommunikációs interface-eket a következő szervízek implementálják. Minden szervíznek kötelező paramétere az API kulcs (token), amely az állásközvetítő cég egyedi azonosítója. Minden kérés header-jében szerepelnie kell az API kulcsnak.
Interfész neve: MER állásközvetítő és álláskölcsönző interfész
Interfész célja: Szabványos webes API biztosítása az állásközvetítő és álláskölcsönző cégektől érkező adatok fogadására.
Megyék lekérdezését biztosító interfész
URL | [BASE URL]/adatszolgaltatas/adatszotar/megyek |
HTTP method | GET |
Protocol | HTTPS |
Port | 443 |
No auth
Key | Value |
X-API-Key | [API Key] |
Accept-Language | hu-HU (Default) |
Content-Type | application/json |
Cache-Control | no-cache |
REQUEST BODY
{}
POSTMAN CLIENT
Request:
{
"info": {
"_postman_id": "bb1004f9-0b51-4961-b598-72a4cb544ae2",
"name": "AdatSzotar",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
},
"item": [
{
"name": "Megyek",
"protocolProfileBehavior": {
"disabledSystemHeaders": {
"user-agent": true,
"accept": true,
"accept-encoding": true,
"connection": true
}
},
"request": {
"auth": {
"type": "apikey",
"apikey": [
{
"key": "value",
"value": "{{ApiKeyValue}}",
"type": "string"
},
{
"key": "key",
"value": "{{ApiKeyName}}",
"type": "string"
},
{
"key": "in",
"value": "header",
"type": "string"
}
]
},
"method": "GET",
"header": [],
"url": {
"raw": "{{BaseUrl}}/adatszolgaltatas/adatszotar/megyek",
"host": [
"{{BaseUrl}}"
],
"path": [
"adatszolgaltatas",
"adatszotar",
"megyek"
]
}
},
"response": []
}
],
"auth": {
"type": "apikey",
"apikey": [
{
"key": "key",
"value": "4A17D7EC-896F-4685-BA26-DBEC10AB3DFF",
"type": "string"
},
{
"key": "value",
"value": "teszt.newid",
"type": "string"
}
]
},
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
}
RESULTS
[MegyeListDto {
id integer($int32)
nev string nullable: true
}]
[
{
"id": 1,
"nev": "Bács-Kiskun"
},
{
"id": 2,
"nev": "Baranya"
},
{
"id": 3,
"nev": "Békés"
},
{
"id": 4,
"nev": "Borsod-Abaúj-Zemplén"
},
{
"id": 5,
"nev": "Budapest"
},
{
"id": 6,
"nev": "Csongrád"
},
{
"id": 7,
"nev": "Fejér"
},
{
"id": 8,
"nev": "Győr-Moson-Sopron"
},
{
"id": 9,
"nev": "Hajdú-Bihar"
},
{
"id": 10,
"nev": "Heves"
},
{
"id": 11,
"nev": "Jász-Nagykun-Szolnok"
},
{
"id": 12,
"nev": "Komárom-Esztergom"
},
{
"id": 13,
"nev": "Nógrád"
},
{
"id": 14,
"nev": "Pest"
},
{
"id": 15,
"nev": "Somogy"
},
{
"id": 16,
"nev": "Szabolcs-Szatmár-Bereg"
},
{
"id": 17,
"nev": "Tolna"
},
{
"id": 18,
"nev": "Vas"
},
{
"id": 19,
"nev": "Veszprém"
},
{
"id": 20,
"nev": "Zala"
}
]
Feorok lekérdezését biztosító interfész
URL | [BASE URL]/adatszolgaltatas/adatszotar/feorok |
HTTP method | GET |
Protocol | HTTPS |
Port | 443 |
No auth
Key | Value |
X-API-Key | [API Key] |
Accept-Language | hu-HU (Default) |
Content-Type | application/json |
Cache-Control | no-cache |
{}
Request:
{
"info": {
"_postman_id": "bb1004f9-0b51-4961-b598-72a4cb544ae2",
"name": "AdatSzotar",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
},
"item": [
{
"name": "Feorok",
"request": {
"auth": {
"type": "apikey",
"apikey": [
{
"key": "value",
"value": "{{ApiKeyValue}}",
"type": "string"
},
{
"key": "key",
"value": "{{ApiKeyName}}",
"type": "string"
},
{
"key": "in",
"value": "header",
"type": "string"
}
]
},
"method": "GET",
"header": [],
"url": {
"raw": "{{BaseUrl}}/adatszolgaltatas/adatszotar/feorok",
"host": [
"{{BaseUrl}}"
],
"path": [
"adatszolgaltatas",
"adatszotar",
"feorok"
]
}
},
"response": []
}
],
"auth": {
"type": "apikey",
"apikey": [
{
"key": "key",
"value": "4A17D7EC-896F-4685-BA26-DBEC10AB3DFF",
"type": "string"
},
{
"key": "value",
"value": "teszt.newid",
"type": "string"
}
]
},
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
}
[
{
"id": 0,
"nev": "string",
"szam": "string"
}
]
[
{
"szam": "0110",
"id": 153,
"nev": "Fegyveres szervek felsőfokú képesítést igénylő foglalkozásai"
},
{
"szam": "0210",
"id": 242,
"nev": "Fegyveres szervek középfokú képesítést igénylő foglalkozásai"
},
{
"szam": "0310",
"id": 485,
"nev": "Fegyveres szervek középfokú képesítést nem igénylő foglalkozásai"
},
{
"szam": "1110",
"id": 1,
"nev": "Törvényhozó, miniszter, államtitkár"
},
…
]
A Vállalkozás típusainak lekérdezését biztosító interfész
URL | [BASE URL]/adatszolgaltatas/adatszotar/VallalkozasTipusok |
HTTP method | GET |
Protocol | HTTPS |
Port | 443 |
No auth
Key | Value |
X-API-Key | [API Key] |
Accept-Language | hu-HU (Default) |
Content-Type | application/json |
Cache-Control | no-cache |
REQUEST BODY
{}
Postman client
Request:
{
"info": {
"_postman_id": "bb1004f9-0b51-4961-b598-72a4cb544ae2",
"name": "AdatSzotar",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
},
"item": [
{
"name": "VallalkozasTipusok",
"request": {
"auth": {
"type": "apikey",
"apikey": [
{
"key": "value",
"value": "{{ApiKeyValue}}",
"type": "string"
},
{
"key": "key",
"value": "{{ApiKeyName}}",
"type": "string"
},
{
"key": "in",
"value": "header",
"type": "string"
}
]
},
"method": "GET",
"header": [],
"url": {
"raw": "{{BaseUrl}}/adatszolgaltatas/adatszotar/VallalkozasTipusok",
"host": [
"{{BaseUrl}}"
],
"path": [
"adatszolgaltatas",
"adatszotar",
"VallalkozasTipusok"
]
}
},
"response": []
}
],
"auth": {
"type": "apikey",
"apikey": [
{
"key": "key",
"value": "4A17D7EC-896F-4685-BA26-DBEC10AB3DFF",
"type": "string"
},
{
"key": "value",
"value": "teszt.newid",
"type": "string"
}
]
},
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
}
[
{
"id": 0,
"nev": "string"
}
]
[
{
"id": 0,
"nev": "Mikro"
},
{
"id": 1,
"nev": "KKV"
},
{
"id": 2,
"nev": "multi-nacionális"
}
]
Országok neve és kódja lekérdezését biztosító interfész
URL [BASE URL]/adatszolgaltatas/adatszotar/orszagok
HTTP GET
method
Protocol HTTPS
Port 443
No auth
Key Value
X-API-Key [API Key]
Accept-Language hu-HU (Default)
Content-Type application/json
Cache-Control no-cache
Request:
{
"info": {
"_postman_id": "bb1004f9-0b51-4961-b598-72a4cb544ae2",
"name": "AdatSzotar",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
},
"item": [
{
"name": "Orszagok",
"request": {
"auth": {
"type": "apikey",
"apikey": [
{
"key": "value",
"value": "{{ApiKeyValue}}",
"type": "string"
},
{
"key": "key",
"value": "{{ApiKeyName}}",
"type": "string"
},
{
"key": "in",
"value": "header",
"type": "string"
}
]
},
"method": "GET",
"header": [],
"url": {
"raw": "{{BaseUrl}}/adatszolgaltatas/adatszotar/Orszagok",
"host": [
"{{BaseUrl}}"
],
"path": [
"adatszolgaltatas",
"adatszotar",
"Orszagok"
]
}
},
"response": []
}
],
"auth": {
"type": "apikey",
"apikey": [
{
"key": "key",
"value": "4A17D7EC-896F-4685-BA26-DBEC10AB3DFF",
"type": "string"
},
{
"key": "value",
"value": "teszt.newid",
"type": "string"
}
]
},
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
}
Adott időszakra sikeresen felküldött állás adatok lekérdezését biztosító interfész
URL | [BASE URL]/adatszolgaltatas/Allas |
HTTP method | GET |
Protocol | HTTPS |
Port | 443 |
No auth
Key | Value |
X-API-Key | [API Key] |
Content-Type | application/json |
Cache-Control | no-cache |
{}
Postman client
Request:
{
"info": {
"_postman_id": "289edae9-e9f7-4817-85da-2f9772fc5e92",
"name": "Allas",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
},
"item": [
{
"name": "Allas",
"request": {
"auth": {
"type": "apikey",
"apikey": [
{
"key": "value",
"value": "{{ApiKeyValue}}",
"type": "string"
},
{
"key": "key",
"value": "{{ApiKeyName}}",
"type": "string"
},
{
"key": "in",
"value": "header",
"type": "string"
}
]
},
"method": "GET",
"header": [],
"url": {
"raw": "{{BaseUrl}}/adatszolgaltatas/allas",
"host": [
"{{BaseUrl}}"
],
"path": [
"adatszolgaltatas",
"allas"
]
}
},
"response": []
}
],
"auth": {
"type": "basic",
"basic": [
{
"key": "username",
"value": "<Basic Auth Username>",
"type": "string"
},
{
"key": "password",
"value": "<Basic Auth Password>",
"type": "string"
}
]
},
"variable": [
{
"key": "baseUrl",
"value": "localhost:3000",
"type": "string"
}
]
}
[AllasListDto{
feorId | integer($int32) |
megyeId | integer($int32) |
allasMegnevezese | string |
hirdetesSzovege | string |
vallalkozasTipusId | integer($int32) |
}]
[
{
"feorId": 333,
"megyeId": 4,
"allasMegnevezese": "Üzletember",
"hirdetesSzovege": "Üzleti szolgáltatási tevékenységet folytató egység vezetője",
"vallalkozasTipusId": 1
},
{
"feorId": 333,
"megyeId": 4,
"allasMegnevezese": "Üzletember",
"hirdetesSzovege": "Üzleti szolgáltatási tevékenységet folytató egység vezetője",
"vallalkozasTipusId": 1
},
{
"feorId": 378,
"megyeId": 2,
"allasMegnevezese": "Gyógyszerész",
"hirdetesSzovege": "Gyógyszerészt keresnek ",
"vallalkozasTipusId": 0
},
{
"feorId": 378,
"megyeId": 2,
"allasMegnevezese": "Gyógyszerész",
"hirdetesSzovege": "Gyógyszerészt keresnek ",
"vallalkozasTipusId": 0
}
]
Állás adatok felküldése
URL | [BASE URL]/adatszolgaltatas/Allas |
HTTP method | POST |
Protocol | HTTPS |
Port | 443 |
No auth
Key | Value |
X-API-Key | [API Key] |
Accept-Language | hu-HU (Default) |
Content-Type | application/json |
Cache-Control | no-cache |
{
"allasok": [
{
"feorSzam": "string",
"megyeId": 0,
"vallalkozasTipusId": 0,
"allasMegnevezese": "string",
"hirdetesSzovege": "string"
}
]
}
Postman client
Request:
{
"info": {
"_postman_id": "289edae9-e9f7-4817-85da-2f9772fc5e92",
"name": "Allas",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
},
"item": [
{
"name": "Allas",
"request": {
"auth": {
"type": "apikey",
"apikey": [
{
"key": "value",
"value": "{{ApiKeyValue}}",
"type": "string"
},
{
"key": "key",
"value": "{{ApiKeyName}}",
"type": "string"
},
{
"key": "in",
"value": "header",
"type": "string"
}
]
},
"method": "POST",
"header": [],
"body": {
"mode": "raw",
"raw": "{\r\n \"allasok\": [\r\n {\r\n \"feorSzam\": \"2214\",\r\n \"megyeId\": 2,\r\n \"vallalkozasTipusId\": 0,\r\n \"allasMegnevezese\": \"Gyógyszerész\",\r\n \"hirdetesSzovege\": \"Gyógyszerészt keresnek \"\r\n },\r\n {\r\n \"feorSzam\": \"1334\",\r\n \"megyeId\": 4,\r\n \"vallalkozasTipusId\": 1,\r\n \"allasMegnevezese\": \"Üzletember\",\r\n \"hirdetesSzovege\": \"Üzleti szolgáltatási tevékenységet folytató egység vezetője\"\r\n }\r\n ]\r\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "{{BaseUrl}}/adatszolgaltatas/allas",
"host": [
"{{BaseUrl}}"
],
"path": [
"adatszolgaltatas",
"allas"
]
}
},
"response": []
}
],
"auth": {
"type": "basic",
"basic": [
{
"key": "username",
"value": "<Basic Auth Username>",
"type": "string"
},
{
"key": "password",
"value": "<Basic Auth Password>",
"type": "string"
}
]
},
"variable": [
{
"key": "baseUrl",
"value": "localhost:3000",
"type": "string"
}
]
}
Kód | Hibajelenség | Megoldás |
200 | Success | Minden rendben lezajlott |
400 | Bad Request | Hibás kérés A hiba oka a Body-ban található |
401 | Jogosultságkezelés probléma hiányzik vagy hibás az API-key a headerben. |
[BASE URL]:
https://kretamerapi.e-kreta.hu
ADATSZÓTÁRAK:
https://kretamerapi.e-kreta.hu/adatszolgaltatas/adatszotar/
ÁLLÁS ADATOK KEZELÉSE
https://kretamerapi.e-kreta.hu/adatszolgaltatas/allas/
[BASE URL]:
https://kretamerapi.ekreta-uat.hu
ADATSZÓTÁRAK:
https://kretamerapi.ekreta-uat.hu/adatszolgaltatas/adatszotar/
ÁLLÁS ADATOK KEZELÉSE
https://kretamerapi.ekreta-uat.hu/adatszolgaltatas/allas/
A MER fenntartja a jogot, hogy a beküldött adatok minőségét ellenőrizze. Ennek érdekében az állásközvetítő szoftverekkel kapcsolatos elvárások az adatok beküldése során a következőek:
Ügyfészolgálati emailcím: ugyfelszolgalat@ekreta.hu
Telefonszám: +36-1-999-1700; +36-1-5100-494