Wykonanie żądania
Uzyskaj token przy użyciu identyfikatora i sekretu klienta, a następnie wykonaj żądanie API w Postmanie lub interfejsie Swagger.
Tworzenie klienta API
Przed wykonaniem żądania przygotuj klienta API przyciskiem .
Klient umożliwia komunikację maszyna–maszyna. Za pomocą client_id i client_secret można uwierzytelnić się w MINT i wykonywać żądania.
- Client ID: bez spacji; można użyć podkreślenia.
- Nazwa klienta.
- Dozwolone zakresy: w tym przykładzie skupiamy się na zasobach i zgłoszeniach: mint.api_assets oraz mint_api.tickets.
Zakres określa obszar dostępny integracji przez wygenerowany token.
Po dodaniu zakresów i kliknięciu zostanie wygenerowany sekret klienta. Skopiuj go i zachowaj. Ponowne wygenerowanie sekretu unieważnia poprzedni.
Uzyskanie tokenu
Do pobrania tokenu użyjemy Postmana. Utwórz żądanie POST na adres swojej instancji Mint z końcówką /connect/token, na przykład https://rcmintsd.opgksoftware.com/connect/token.
Uzupełnij cztery pola:
- grant_type: client_credentials.
- client_id: identyfikator podany podczas konfiguracji API.
- client_secret: sekret otrzymany po konfiguracji klienta API.
- scope: zakresy wskazane w konfiguracji API.
Użyj formatu x-www-form-urlencoded.
Kliknij „Send”, aby otrzymać token.
Testowanie żądania
Skopiuj token. Możesz sprawdzić go pod adresem your_address_to_mint/swagger/index.html.
Kliknij przycisk i wpisz w polu „Bearer your_token”.
Następnie ponownie kliknij przycisk .
Aby sprawdzić token, przejdź do sekcji zgłoszeń i wybierz /api/Tickets/{ticketId}. Zobaczysz przykład odpowiedzi. Kliknij , wpisz identyfikator zgłoszenia w polu ticketid i wykonaj żądanie przyciskiem Execute.
To samo można sprawdzić w Postmanie, wybierając GET i adres page_address/api/Tickets/{ticketId}, na przykład https://rcmintsd.opgksoftware.com/api/Tickets/{ticketId}.