Poniżej przedstawiamy, w jaki sposób i które pola w Postmanie uzupełnić, aby poprawnie skonfigurować dostęp do API dla aplikacji app.bergsystem.pl oraz dedykowanego systemu klienta.
Zwróć uwagę !
Uzyskane dane należy wpisywać w prawej kolumnie Current Value, chyba że planujesz podzielić się gotową konfiguracją z zespołem. Dane w kolumnie Initial Value są zachowywane podczas eksportu konfiguracji środowiska.
Konfiguracja dla aplikacji app.bergsystem.pl
W pierwszej kolejności należy dodać własną wartość dla pola cloud_client_id_m2m
. W tym celu trzeba przejść do zakładki Ustawienia systemu > Klienci API, następnie dodać własny wpis poprzez kliknięcie przycisku Dodaj oraz wpisanie nazwy w polu Nazwa (Client ID).
Następnie, po zatwierdzeniu poprzez przycisk Dodaj w oknie dodawania nowego klienta API, można przejść do wykonywania kolejnych kroków w Postmanie.
Scope machine_to_machine
Pola, które należy uzupełnić to:
cloud_base_ulr
- adres url aplikacji (wstępnie uzupełniany)cloud_client_id_m2m
- nazwę z Berg System, pobieraną z Ustawienia systemu > Klienci API, tą, która została wcześniej wpisana w pole Identifiercloud_secret
- sekret generowany w Ustawienia systemu > Klienci APItenant
- tenant klienta do skopiowania z tabeli w zakładce Ustawienia systemu > Klienci API
Uwaga!
Podczas dodawania wartości dla pola cloud_client_id_m2m
, po dodaniu i zapisaniu scope machine _to_machine
zostanie wyświetlone dodatkowe okno o nazwie Token (Secret Key), z którego należy skopiować sekret.
Po zakończeniu tworzenia klienta nie jest możliwe ponowne skopiowanie tokena. Jeśli zajdzie taka potrzeba, konieczne będzie dodanie kolejnego klienta machine _to_machine
i usunięcie poprzedniego z utraconym sekretem.
Konfiguracja dla systemu dedykowanego
Scope machine_to_machine
Pola, które należy uzupełnić to:
server_base_url
- adres url Twojej aplikacji czyli https://Twój adres/apiserver_client_id_m2m
- nazwę z Berg System, pobieraną z Ustawienia systemu > Klienci API, tą, która została wcześniej wpisana w pole Identifierserver_secret
- sekret generowany w Ustawienia systemu > Klienci API (opis jak ją uzyskać w części Konfiguracja dla aplikacji app.bergsystem.pl)
Zwróć uwagę!
Dla systemu dedykowanego uzupełnianie pola tenat
nie jest konieczne, pozostaw to pole puste.