API intraservis

Wszystkie usługi działają poprawnie

Podstawowa dokumentacja oraz przykłady użycia API w różnych środowiskach

Eksploruj Endpointy

Poznaj przykładowe funkcje naszego API

Zasób REST
GET /rekrutacja/kampanie

Pobierz listę dostępnych kampanii rekrutacyjnych.

Parametr Typ Wymagane Opis
GET /rekrutacja/stanowiska

Pobierz listę dostępnych stanowisk rekrutacyjnych.

Parametr Typ Wymagane Opis
lang string Nie Wersja językowa zwracanych wyników (domyślnie pl_PL)
GET /rekrutacja/lead/{id} lub /rekrutacja/lead/kampania/{id}

Pobierz dane leada po id lub pobierz listę leadów po id kampanii.

Parametr Typ Wymagane Opis
POST /rekrutacja/lead

Dodaj nowego leada do systemu rekrutacyjnego.

Parametr Typ Wymagane Opis
imie string Tak Imię kandydata
nazwisko string Tak Nazwisko kandydata
telefon string Tak Numer telefonu (numery podane bez kodu kierunkowego zostaną potraktowane jako polskie, numer zostanie znormalizowany automatycznie)
email string Nie Adres email
kampania_id integer Tak ID kampanii
stanowisko integer Nie ID stanowiska
lang string Nie Język kandydata (ISO 639-1 domyślnie pl)
kraj string Nie Kraj kandydata (ISO 3166-1 alpha-2 domyślnie pl)
kraj_oferty string Nie Kraj oferty (ISO 3166-1 alpha-2 domyślnie pl)
GET /praca/oferty lub /praca/oferty/{id}

Pobierz listę wszystkich aktywnych dostępnych ofert lub tylko wybranej po id (w tym przypadku dostępne będą również podobne losowe oferty pracy na podstawie kategorii).

Parametr Typ Wymagane Opis
lang string Nie Wersja językowa zwracanych wyników (domyślnie pl_PL, dostepne opcje ru_RU, uk_UA dla tvojarabota, 11_PL dla intraservis)
limit integer Nie Liczba wyników na stronie (domyślnie 50)
offset integer Nie Offset wyników na stronie (domyślnie 0)
dst_1 integer Nie Dostępność na tvojarabota.pl (wybór 0/1)
dst_2 integer Nie Dostępność na studiujepracuje.pl (wybór 0/1)
dst_3 integer Nie Dostępność na praca.intraservis.pl (wybór 0/1)
kategoria integer Nie Filtrowanie na podstawie id kategorii
miasto integer Nie Filtrowanie na podstawie id miasta
GET /praca/rekruterzy lub /praca/rekruterzy/{id}

Pobierz listę wszystkich dostępnych rekruterów lub tylko wybranego po id.

Parametr Typ Wymagane Opis
wersja integer Nie Wersja wybór dla strony (domyślnie wszystkie)
lang string Nie Wersja językowa zwracanych wyników (domyślnie pl_PL, dostepne opcje ru_RU, uk_UA dla tvojarabota, 11_PL dla intraservis)
limit integer Nie Liczba wyników na stronie (domyślnie 100)
offset integer Nie Offset wyników na stronie (domyślnie 0)
GET /praca/kategorie

Pobierz listę wszystkich dostępnych kategori.

Parametr Typ Wymagane Opis
lang string Nie Wersja językowa zwracanych wyników (domyślnie pl_PL, dostepne opcje ru_RU, uk_UA dla tvojarabota, 11_PL dla intraservis)
limit integer Nie Liczba wyników na stronie (domyślnie 100)
offset integer Nie Offset wyników na stronie (domyślnie 0)
active_only integer Nie Wyświetlanie tylko aktywnych kategorii (domyślnie 1)
GET /praca/miasta lub /praca/miasta/{id}

Pobierz listę wszystkich dostępnych miast lub tylko wybranego po id.

Parametr Typ Wymagane Opis
lang string Nie Wersja językowa zwracanych wyników (domyślnie pl_PL, dostepne opcje ru_RU, uk_UA dla tvojarabota, 11_PL dla intraservis)
limit integer Nie Liczba wyników na stronie (domyślnie 100)
offset integer Nie Offset wyników na stronie (domyślnie 0)
active_only integer Nie Wyświetlanie tylko aktywnych kategorii (domyślnie 1)

Przykłady użycia API

Gotowe fragmenty kodu w różnych językach programowania

PHP
JavaScript
Python
cURL
Java
Przykład dodawania leada w PHP
<?php
$apiKey = 'Twój_klucz_API';
$url = 'https://api.intraservis.pl/rekrutacja/lead';

$data = [
    'imie' => 'Jan',
    'nazwisko' => 'Kowalski',
    'telefon' => '123456789',
    'email' => 'jan@example.com',
    'kampania_id' => 123,
    'stanowisko' => 456,
    'prawo_jazdy_b' => 'tak' //W przypadku dodatkowych pytań jeśli zostały skonfigurowane w kampanii
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'X-API-Key: ' . $apiKey
]);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo "Status: $status\n";
echo "Odpowiedź: $response";
?>
Przykład dodawania leada w JavaScript
const apiKey = 'Twój_klucz_API';
const url = 'https://api.intraservis.pl/rekrutacja/lead';

const data = {
    imie: 'Jan',
    nazwisko: 'Kowalski',
    telefon: '123456789',
    email: 'jan@example.com',
    kampania_id: 123,
    stanowisko: 456,
    prawo_jazdy_b: 'tak' //W przypadku dodatkowych pytań jeśli zostały skonfigurowane w kampanii
};

fetch(url, {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'X-API-Key': apiKey
    },
    body: JSON.stringify(data)
})
.then(response => {
    console.log('Status:', response.status);
    return response.json();
})
.then(data => console.log('Odpowiedź:', data))
.catch(error => console.error('Błąd:', error));
Przykład dodawania leada w Python
import requests

api_key = 'Twój_klucz_API'
url = 'https://api.intraservis.pl/rekrutacja/lead'

data = {
    'imie': 'Jan',
    'nazwisko': 'Kowalski',
    'telefon': '123456789',
    'email': 'jan@example.com',
    'kampania_id': 123,
    'stanowisko': 456,
    'prawo_jazdy_b': 'tak' #W przypadku dodatkowych pytań jeśli zostały skonfigurowane w kampanii
}

headers = {
    'Content-Type': 'application/json',
    'X-API-Key': api_key
}

response = requests.post(url, json=data, headers=headers)
print(f'Status: {response.status_code}')
print(f'Odpowiedź: {response.json()}')
Przykład dodawania leada z cURL
curl -X POST \
  https://api.intraservis.pl/rekrutacja/lead \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: Twój_klucz_API' \
  -d '{
    "imie": "Jan",
    "nazwisko": "Kowalski",
    "telefon": "123456789",
    "email": "jan@example.com",
    "kampania_id": 123,
    "stanowisko": 456,
    "prawo_jazdy_b": "tak" #W przypadku dodatkowych pytań jeśli zostały skonfigurowane w kampanii
}'
Przykład dodawania leada w Java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class AddLeadExample {
    public static void main(String[] args) throws Exception {
        String apiKey = "Twój_klucz_API";
        String url = "https://api.intraservis.pl/rekrutacja/lead";
        
        String json = "{\"imie\":\"Jan\",\"nazwisko\":\"Kowalski\",\"telefon\":\"123456789\",\"email\":\"jan@example.com\",\"kampania_id\":123,\"stanowisko\":456}";
        
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .header("Content-Type", "application/json")
                .header("X-API-Key", apiKey)
                .POST(HttpRequest.BodyPublishers.ofString(json))
                .build();
        
        HttpResponse<String> response = client.send(
                request, HttpResponse.BodyHandlers.ofString());
        
        System.out.println("Status: " + response.statusCode());
        System.out.println("Odpowiedź: " + response.body());
    }
}