API RCPonline umożliwia integrację zewnętrznych aplikacji z systemem, co pozwala na automatyzację procesów oraz dostęp do danych w czasie rzeczywistym. W tym artykule omówimy, jak skonfigurować dostęp do API, wygenerować tokeny uwierzytelniające, a także jak wykonywać zapytania.
1. Strona API
Link do strony API:
https://api.rcponline.pl/
2. Tworzenie konta dostępowego
Aby korzystać z API, najpierw należy utworzyć konto dostępowe:
Ścieżka funkcjonalności:
Konfiguracja → Dostęp API → Dodaj
Uzupełnij pola:
Adres e-mail: Wprowadź adres e-mail do autoryzacji w API.
Hasło: Ustaw hasło do konta API.
Zapisz dane – użytkownik pojawi się na liście, a jego dane będą gotowe do użycia.
3. Generowanie tokenu uwierzytelniającego
Token uwierzytelniający pozwala na autoryzację w API. Aby go wygenerować:
Przejdź do narzędzi dewelopera:
Kliknij przycisk „Przejdź do narzędzi dewelopera” w systemie lub skorzystaj z linku w artykule.
W narzędziach dewelopera znajdź zapytanie oznaczone jako „token”.
Kliknij „Try it out”, uzupełnij pola danymi użytkownika stworzonego w kroku 2 i wykonaj zapytanie.
Przykładowe zapytanie w CURL:
bashKopiujEdytujcurl -X 'POST' \ 'https://api.rcponline.pl/api/login_check' \ -H 'accept: application/json' \ -H 'Content-Type: application/json' \ -d '{ "email": "[email protected]", "password": "password" }'Przykładowa odpowiedź:
jsonKopiujEdytuj{ "token": "eyJ0eXAiOiJKV1QiLCJ...", "refresh_token": "49256a9d..." }4. Autoryzacja użytkownika
Po wygenerowaniu tokenu należy go użyć do autoryzacji:
Kliknij przycisk „Authorize” w prawym górnym rogu strony API.
Wpisz token w formacie:
Bearer [token]Zatwierdź autoryzację – teraz możesz wysyłać zapytania do API.
5. Wysyłanie zapytań do API
Aby wysłać zapytanie:
Wybierz z menu sekcję danych, które chcesz uzyskać, np. Employer.
Ustaw filtry, aby doprecyzować zapytanie.
Kliknij przycisk „Execute”.
Odpowiedź serwera:
Kod CURL: Możesz użyć go do automatyzacji w aplikacji.
URL zapytania: Adres endpointa użytego zapytania.
Odpowiedź serwera: Zawiera dane zwrócone przez API.
📌 Wskazówka: Na dole strony znajdziesz szczegółowy opis pól w odpowiedzi i przykłady danych.
6. Odświeżanie tokenu (Refresh Token)
Tokeny są ważne przez ograniczony czas:
Token: 30 minut.
Refresh token: 1 miesiąc.
Aby odświeżyć token, możesz użyć następującego zapytania w CURL:
bashKopiujEdytujcurl -X 'POST' \ 'https://api.rcponline.pl/api/token/refresh' \ -H 'accept: application/json' \ -H 'Content-Type: application/json' \ -d '{ "refresh_token": "fc4d42770decef9a287b..." }'7. Częste pytania i wskazówki
Czy mogę korzystać z wielu kont API?
Tak, możesz utworzyć wiele kont z różnymi poziomami dostępu.Czy mogę zautomatyzować zapytania?
Tak, używając kodów CURL w aplikacjach zewnętrznych.Jakie dane są dostępne przez API?
Wszystkie dane widoczne w narzędziach dewelopera – pełen opis znajdziesz w dokumentacji API.
Podsumowanie
Dzięki API RCPonline możesz zintegrować system z innymi aplikacjami, automatyzując procesy i zwiększając efektywność zarządzania danymi. Jeśli masz pytania lub napotkasz trudności, skontaktuj się z naszym zespołem wsparcia.