Módosítva ekkor: 16 Aug, 2026

Ez az útmutató a Jooble REST API integrációjához nyújt támogatást. Az alábbiakban információkat talál az API-kulcs generálásáról, a végpontokról, a kérelemparaméterekről, a JSON formátumokról és a gyakori válaszkódokról. Ha még nem kezdte el az integrációt, kérjük, tekintse meg lépésenkénti útmutatónkat a Hogyan csatlakozzon a Jooble REST API-hoz? témában.

Fontos regionális korlátozások:
Minden Jooble-domén (ország) saját, egyedi REST API-kulcsot igényel. Például a jooble.org-on generált kulcs kizárólag az egyesült államokbeli álláshirdetésekhez biztosít hozzáférést. Más országok állásajánlatainak lekérdezéséhez regisztráljon, és igényeljen API-kulcsot a megfelelő regionális doménen (például hu.jooble.org/api/about Magyarország esetében).

API használati korlátok:
Az ingyenes REST API csomag kulcsonként összesen 500 lekérdezést tesz lehetővé (ez egy egyszeri élettartamra vonatkozó kvóta, nem havi limit).

Jooble REST API-kulcs igénylése

1. Regisztráljon fiókot a Jooble API-portálon a célországának megfelelően (pl. hu.jooble.org/api/about).
2. A regisztrációt követően másolja ki és tárolja biztonságos helyen a generált API-kulcsot.

Kérelemparaméterek (JSON törzs)

A kérelem adattartalmát application/json formátumban kell elküldeni az alábbi paraméterekkel:

• keywords(karakterlánc, kötelező): Kulcsszavak vagy pozíciónevek a kereséshez.
• location(karakterlánc, kötelező): Helyszín (város, megye vagy ország).
• radius(karakterlánc, nem kötelező): Keresési sugár kilométerben. Megengedett értékek: 0, 4, 8, 16, 26, 40, 80.
• salary(egész szám, nem kötelező): Minimális fizetési küszöb.
• page(egész szám, nem kötelező): A keresési találatok oldalszáma (alapértelmezett: 1).
• ResultOnPage(egész szám, nem kötelező): Oldalanként megjelenített álláshirdetések száma.
• SearchMode(egész szám, nem kötelező): Keresési algoritmus módja (alapértelmezett: 0).
• companysearch(logikai érték, nem kötelező):
  • true – Kulcsszavak keresése kifejezetten a vállalatnevekben.
  • false – Kulcsszavak keresése az álláshirdetések címeiben és leírásaiban.

Válaszparaméterek

Sikeres kérelem esetén a szerver egy JSON objektumot küld vissza, amely a következőket tartalmazza:

• totalCount(egész szám): A talált álláshirdetések összesített száma.
• jobs(tömb): Az álláshirdetések listája, amely a következőket tartalmazza:
  • id(egész szám): Az álláshirdetés egyedi azonosítója.
  • title(karakterlánc): Az állás megnevezése.
  • location(karakterlánc): Az állás helyszíne.
  • snippet(karakterlánc): Rövid leírás, amely a találati listában jelenik meg.
  • salary(karakterlánc): Fizetési tartomány {min} - {max} {valutanem} formátumban.
  • source(karakterlánc): A hirdetés forrása.
  • type(karakterlánc): Foglalkoztatás típusa (pl. Teljes munkaidős, Részmunkaidős).
  • link(karakterlánc): Közvetlen URL a Jooble-on található álláshirdetéshez.
  • company(karakterlánc): A vállalat neve.
  • updated(karakterlánc): Az álláshirdetés utolsó frissítésének ISO időbélyege.

JSON kérelem és válasz példák

Példa a kérelemre:

Példa sikeres válaszra (200 OK):

HTTP válasz- és hibakódok

• 200 OK: A kérelem sikeres volt és adatokat adott vissza.
• 403 Access Denied: Érvénytelen vagy hiányzó API-kulcs.
• 404 Not Found: A kért végpont vagy erőforrás nem található.

Implementációs példák

A Jooble REST API-t olyan programozási nyelveken integrálhatja, mint a PHP, JavaScript, Python (2.7 / 3.5+), C# (.NET 4+), Ruby és mások. A használatra kész kódpéldák és implementációs útmutatók elérhetőek a Jooble API dokumentációs oldalán.