Tutaj znajdziesz informacje o endpointach, parametrach odpowiedzi i możliwych błędach kodu po podłączeniu za pomocą klucza API REST. Jeśli jeszcze się nie połączyłeś, postępuj zgodnie z krokami w tym przewodniku, aby rozpocząć.

Jak zdobyć klucz API?
Zarejestruj się na stronie: pl.jooble.org/api/about
Po rejestracji skopiuj i zapisz klucz API, który został dla Ciebie wygenerowany.

Endpointy
Poniżej znajdziesz dostępne endpointy, których możesz używać do interakcji z API REST Jooble w celu pobrania żądanych danych.

Parametry zapytania:
POST /api/{api_Key} 

  • keywords: Słowa kluczowe do wyszukiwania ofert pracy.
  • location: Lokalizacja do wyszukiwania ofert pracy.
  • radius (optional): Promień wyszukiwania, podany w kilometrach (typ: string).
  • salary (optional): Minimalne wynagrodzenie do wyszukiwania ofert pracy (typ: integer).
  • page (optional): Numer strony wyników wyszukiwania.
  • ResultOnPage (optional): Liczba ofert pracy wyświetlanych na każdej stronie.
  • SearchMode (optional): Tryb wyszukiwania, domyślnie 0.
  • companysearch (optional):
    • true – Wyszukuj słowa kluczowe w nazwie firmy pracy.
    • false – Wyszukuj słowa kluczowe w tytule pracy lub opisie.

Parametry odpowiedzi:

  • totalCount: Łączna liczba ofert pracy znalezionych dla zapytania wyszukiwania.
  • jobs: Lista ofert pracy odpowiadających kryteriom wyszukiwania:
  • title: Tytuł pracy.
  • location: Lokalizacja pracy.
  • snippet: Opis pracy wyświetlany w wynikach wyszukiwania.
  • salary: Zakres wynagrodzenia w formacie {job.salary_val1} - {job.salary_val2} {currency}.
  • source: Źródło ogłoszenia o pracę.
  • type: Typ pracy (pełny etat, niepełny etat itd.).
  • link: URL ogłoszenia o pracę.
  • company: Nazwa firmy.
  • updated: Data i godzina, kiedy oferta pracy została ostatnio zaktualizowana.
  • id: Unikalny identyfikator pracy.

Przykład zapytania JSON
POST https://jooble.org/api/{api_Key}

{
  "keywords": "Menadżer sprzedaży, Administrator",
  "location": "Warszawa",
  "radius": "80",
  "page": "1",
  "companysearch": "false"
}
Udana odpowiedź: 200 OK

{  "totalCount": 1,  
    "jobs": [    
    {   "title": "Menadżer sprzedaży",      
        "location": "Warszawa",      
        "snippet": "To świetna okazja, aby dołączyć do naszego zespołu...",      
        "salary": "17 600 PLN",      
        "source": "jooble",      
        "type": "Pełny etat",      
        "link": "https://pl.jooble.org/jdp/12345",      
        "company": "ABC Corp",      
        "updated": "2023-09-15T12:55:35.3870000",      
        "id": 1234567890    }  ] 
}
Odpowiedzi na błędy:
403: Access denied – Nieprawidłowy klucz API.
404: Not found – Żądany punkt końcowy lub zasób jest niedostępny.

Przykład użycia Jooble API w kodzie
Możesz wdrożyć Jooble API używając PHP, JavaScript, Ruby, C# (.NET 4 lub nowszy), Python 3.5 lub Python 2.7. Szczegółowe przykłady kodu dla każdego języka można znaleźć na stronie API Jooble tutaj, pokaż je swojemu programiście.

Dokumentacja Jooble REST API Przewodnik Endpointy