Jak wysłać dane z Aplikacji Gamfi do innych lokalizacji i/lub systemów?

Wykorzystaj do tego Akcję “Transfer danych” - to kolejna z akcji “w tle”, czyli taka, która znajduje się w Workflow, ale jest niewidoczna w Portalu Użytkownika. Jest to sposób na bezpieczne przekazanie zebranych od Użytkownika danych.

Czym jest “Transfer danych”?

Akcja “Transfer danych” pozwala na wysyłanie danych do określonego URL w momencie wystąpienia pewnych zdarzeń ustalonych w Workflow. W przeciwieństwie do tradycyjnego API, które wymaga okresowego odpytywania, aby sprawdzić, czy nastąpiła zmiana - webhooki automatycznie wysyłają informacje, gdy tylko wystąpi dane zdarzenie.

Jak zebrać od użytkowników dane i przekazać je dalej_6

Za pomocą akcji “Transfer danych” można przesłać do zewnętrznej aplikacji wybrane dane z procesu np. imię i nazwisko pracownika, datę jego zatrudnienia itp. - za pomocą metody POST. 

Aplikacja odbierająca musi potrafić wyświetlać wszystkie otrzymane zapytania HTTP, które zostały wysłane na ten unikalny URL. 

Dla testów akcji “Transfer danych” można skorzystać z serwisu https://webhook.site/, który:

  • automatycznie wygeneruje unikalny URL. Ten URL działa jako “endpoint”, czyli punkt końcowy, na który aplikacje mogą wysyłać dane.
  • otrzyma i wyświetli wszystkie otrzymane zapytania HTTP, które zostały wysłane na ten unikalny URL za pomocą akcji “Transfer danych”.

W akcji “Transfer danych” można skorzystać z funkcji “Send test”, która wysyła na podany URL testowe dane oraz kształt JSONa.

W przypadku wysyłania plików, akcja “Data transfer” zwróci do odbiorcy adres URL do pliku, który umożliwia jego pobranie. Do pobrania pliku konieczne jest posiadanie kluczy API KEY oraz API SECRET (możesz to zrobić tutaj: https://gamfi.support/help/quickstart), które służą do autoryzacji podczas pobierania.

GET + URL zwrócony przez akcję ”Data transfer”

Aby pobrać raport z listą procesów z Gamfi skorzystaj z metody i endpointa: GET + URL zwrócony przez akcję ”Data transfer”.

Przykładowy cURL:

curl --location '' \

--header 'X-Samus-Authorization-Api-Key: {apiKey}' \

--header 'X-Samus-Authorization-Api-Secret: {apiSecret}' \

--header 'Content-Type: application/json'

W miejscu:

  • {URL} - zwrócony przez akcję ”Data transfer” URL do pliku
  • {apiKey} - wstaw klucz API
  • {apiSecret} - wstaw sekret API

W przypadku prawidłowej odpowiedzi (200) rozpocznie się pobieranie pliku.