Centrum wsparcia Workiva

Chcesz połączyć się z aplikacją innej firmy poza wbudowanymi złączami Premium firmy Workiva? Można to osiągnąć, wykorzystując polecenia HTTP Request Connector do interakcji z interfejsami API REST. 

W ramach tej połączonej ścieżki edukacyjnej utworzymy łańcuch uwierzytelniany za pomocą interfejsu API innej firmy w celu uzyskania tokena nośnika. Choć pokażemy to na przykładzie interfejsu API Workiva, zasady i proces można zastosować do połączenia z różnymi innymi interfejsami API.

Krok 1: Utwórz zmienne obszaru roboczego

Aby móc korzystać ze szczegółów interfejsu API Workiva w wielu łańcuchach i poleceniach, utworzymy zmienne obszaru roboczego służące do przechowywania tych informacji. Utworzymy trzy zmienne obszaru roboczego dla następujących danych: identyfikator klienta API Grant, klucz tajny klienta oraz podstawowy adres URL IAM (zarządzanie tożsamościami i dostępem).

1. Z Chain Builderprzejdź do Workspace Settings.
2. W Zmienne obszaru roboczegokliknij znak plus (+) trzy razy, aby utworzyć trzy zmienne obszaru roboczego i skonfigurować je w następujący sposób:
   • Zmienna 1:
     • Nazwa: Identyfikator klienta API wsv-Workiva
     • Wartość: Wprowadź Identyfikator klienta swojego API Grant.
       Aby znaleźć identyfikator klienta, przejdź do swojego profilu na platformie Workiva i znajdź API Grant na karcie Bezpieczeństwo.
       Aby uzyskać dalszą pomoc dotyczącą dotacji API, postępuj zgodnie z poniższymi instrukcjami.
   • Zmienna 2:
     • Nazwa: wsv-Workiva API Client Secret
     • Wartość: Wprowadź Identyfikator klienta swojego API Grant.
       Aby znaleźć tajny klucz klienta, przejdź do swojego profilu na platformie Workiva i znajdź API Grant na karcie Bezpieczeństwo.
       Aby uzyskać więcej pomocy w znalezieniu tajnego klucza klienta, postępuj zgodnie z poniższymi instrukcjami

     • Kliknij przycisk kłódki, aby zaszyfrować tajny klucz klienta.

       Ważne jest, aby chronić Tajemnice Klienta. Zapisz Tajemnicę Klienta w bezpiecznym miejscu na wypadek, gdybyś potrzebował dostępu do niej ponownie.

   • Zmienna 3:

     • Nazwa: wsv-BaseURL-IAM
     • Wartość: Wprowadź poniżej wartość odpowiadającą Twojemu regionowi. Możesz zweryfikować region, sprawdzając adres URL. Jeśli adres URL zawiera EU lub APAC, użyj odpowiedniego adresu URL.

     Uwaga: Region USA zawiera tylko „aplikację”.

     • Region USA
     • Region UE
     • Region Azji i Pacyfiku

     Pole	Wartość amerykańska
     Podstawowy adres URL IAM	https://api.app.wdesk.com

     Pole	Wartość UE
     Podstawowy adres URL IAM	https://api.eu.wdesk.com

     Pole	Wartość APAC
     Podstawowy adres URL IAM	https://api.apac.wdesk.com

   • Zapisz ustawienia obszaru roboczego.

Krok 2: Utwórz łańcuch

Aby wygenerować token nośnika, utworzymy nowy łańcuch za pomocą polecenia POST; dzięki temu otrzymamy potrzebny nam token nośnika.

1. Przejdź do zakładki Łańcuchy w Konstruktorze łańcuchów.
2. Utwórz nowy łańcuch i nazwij go: CLP | Generuj token dostępu.
3. Dodaj Opis: Ten łańcuch generuje nowy token dostępu API Workiva. Musisz podać prawidłowy identyfikator klienta i tajny klucz klienta z wcześniej wygenerowanego zezwolenia API w wartościach zmiennych poniżej.
4. Zapisz łańcuch.

Krok 3: Odzyskaj token

Ten łańcuch używa polecenia POST z łącznika żądań HTTP w celu pobrania naszego tokena nośnika. Token nośnika to kluczowy element uwierzytelniający wymagany do uzyskania dostępu do interfejsów API. Po uzyskaniu tokena w ramach Łańcucha można go używać w kolejnych Poleceniach w celu autoryzacji interakcji z API.

1. Dodaj polecenie Post z łącznika HTTP Request do obszaru Start.
2. Kliknij dwukrotnie polecenie, aby je skonfigurować.
   • Zmień nazwę polecenia: POST - Pobierz token.
   • Zaznacz pole wyboru Pokaż odpowiedź.
   • W polu URL wpisz adres URL punktu końcowego, do którego chcesz dotrzeć. Aby pobrać token dla interfejsu API Workiva, wpisz poniższy kod w adresie URL, używając zmiennej obszaru roboczego do wpisania adresu URL bazy IAM.
     1. Kliknij w URL, a następnie kliknij Obszar roboczy w panelu „Wybierz zmienną” i wybierz zmienną utworzoną w kroku 1 (wsv-BaseURL-IAM).
     2. Dodaj /oauth2/token po zmiennej.
   • W polu Typ zawartości wprowadź: application/x-www-form-urlencoded.

• Użyj znaku Plus, aby dodać pole Nagłówek .
  • Klawisz: Akceptuj
  • Wartość: aplikacja/json

• Użyj znaku Plus, aby dodać kolejne pole Nagłówek .
  • Klucz: Wersja X
  • Wartość: 2026-01-01

Poinformujemy punkt końcowy, jak wykonać polecenie, korzystając z parametrów wprowadzonych do formularza postu. Aby to zrobić, kliknij zielony przycisk plus obok sekcji Formularz cztery razy i wypełnij każde pole podanymi poniżej wartościami, zwracając szczególną uwagę na wielkość liter.

• Pole 1:
  • Nazwa: identyfikator_klienta
  • Wartość: <wsv-Workiva API Client ID>
    W panelu Wybierz zmiennąkliknij strzałkę w dół, aby rozwinąć Obszar roboczy i wybierz Identyfikator klienta API wsv-Workiva.
• Pole 2:
  • Nazwa: sekret_klienta
  • Wartość: <wsv-Workiva API Client Secret>
    W panelu Wybierz zmiennąkliknij strzałkę w dół, aby rozwinąć Obszar roboczy i wybierz Klucz tajny klienta API wsv-Workiva.
• Pole 3:
  • Nazwa: typ_grantu
  • Wartość: dane_klienta
• Pole 4:
  • Nazwa: zakres
  • Wartość: Opcjonalnie dodaj tutaj wartość, aby określić, do których zakresów ten token powinien mieć dostęp.

• Wypełnij Odpowiedź przykładowym ładunkiem poniżej. W ten sposób zapewnimy format wynikom polecenia, dzięki czemu każda zwrócona zmienna będzie łatwiejsza w użyciu.

  { "access_token": "ciąg", "expires_in": "liczba całkowita", "scope": "ciąg", "token_type": "ciąg" }

3. (Opcjonalnie) Wprowadź Opis: „To polecenie HTTP wykonuje wywołanie POST w celu wygenerowania tokena dostępu potrzebnego do uwierzytelnienia w kolejnych poleceniach HTTP przy użyciu interfejsu API Workiva IAM. To polecenie wykorzystuje zmienne obszaru roboczego do przechowywania adresu URL bazowego dla interfejsu API Workiva IAM oraz identyfikatora klienta API Grant i tajnego klucza klienta. Więcej informacji można znaleźć tutaj: https://developers.workiva.com/2026-01-01/tokenrequest.html.
4. Zapisz polecenie.

Wskazówka! Aby dowiedzieć się, jak wypełniać pola formularza i odpowiedzi, zapoznaj się z dokumentacją programistyczną dotyczącą punktu końcowego interfejsu API, z którym chcesz się połączyć. W przypadku interfejsu API Workiva dokumentację Bearer Token można znaleźć tutaj.

Krok 4: Przetestuj ćwiczenie

Teraz, gdy łańcuch jest gotowy, można przetestować wynik.

1. Opublikuj Łańcuch.
2. Kliknij Wykonaj, a następnie Uruchom łańcuch.

3. Po zakończeniu działania łańcucha powinieneś zobaczyć, że token dostępu został wygenerowany na karcie Wyniki - Treść odpowiedzi polecenia Post.

   

Sprawdź następne ćwiczenie w ścieżce nauki połączonej z żądaniem HTTP, aby dowiedzieć się , jak używać tokenu nośnika w kolejnych arkuszach kalkulacyjnych listy poleceń.