Jak skonfigurować dostęp do API? ​

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

  1. Uzupełnij pola:
    • Adres e-mail: Wprowadź adres e-mail do autoryzacji w API.
    • Hasło: Ustaw hasło do konta API.
  2. 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ć:

  1. Przejdź do narzędzi dewelopera:
    • Kliknij przycisk „Przejdź do narzędzi dewelopera” w systemie lub skorzystaj z linku w artykule.
  2. W narzędziach dewelopera znajdź zapytanie oznaczone jako „token”.
  3. Kliknij „Try it out”, uzupełnij pola danymi użytkownika stworzonego w kroku 2 i wykonaj zapytanie. Przykładowe zapytanie w CURL:
Request
curl -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ź:

Response
{ "token": "eyJ0eXAiOiJKV1QiLCJ...", "refresh_token": "49256a9d..." }

4. Autoryzacja użytkownika ​

Po wygenerowaniu tokenu należy go użyć do autoryzacji:

  1. Kliknij przycisk „Authorize” w prawym górnym rogu strony API.
  2. Wpisz token w formacie:
    Bearer [token]
  3. Zatwierdź autoryzację – teraz możesz wysyłać zapytania do API.

5. Wysyłanie zapytań do API ​

Aby wysłać zapytanie:

  1. Wybierz z menu sekcję danych, które chcesz uzyskać, np. Employer.
  2. Ustaw filtry, aby doprecyzować zapytanie.
  3. 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:

curl -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.