Przejdź do treści

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