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) |
| 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());
}
}