Przeskocz do zawartości głównej Przejdź do treści uzupełniającej

Tworzenie webhooków do przepływów pracy i zarządzanie nimi

Webhooki to prosty sposób na automatyzację komunikacji między aplikacjami przez automatyczne wysyłanie danych zdarzeń, gdy wystąpią określone działania. W Qlik Cloud webhooki mogą wyzwalać działania w innych aplikacjach bez ręcznej interwencji, ułatwiając integrację Qlik Cloud z przepływami pracy i automatyzację zadań w oparciu o zdarzenia systemowe. Za każdym razem, gdy wystąpi zdefiniowane zdarzenie, żądanie JSON jest wysyłane do określonego punktu końcowego webhooka, dostarczając dane zdarzenia do wybranej aplikacji.

Informacje o webhookach

Jak działają webhooki?

Gdy w Qlik Cloud wystąpi zdarzenie (np. utworzono nową aplikację lub usunięto użytkownika), webhook wysyła informacje w formacie JSON do określonej aplikacji zewnętrznej za pomocą wywołania zwrotnego HTTP. Zewnętrzna aplikacja może następnie wykorzystać dane zdarzenia do uruchomienia dalszych działań.

Na przykład:

  • Powiadamianie zespołu przez Slack o utworzeniu nowej aplikacji.

  • Automatyczne wysyłanie powitalnej wiadomości e-mail członkowi zespołu nowo dodanemu do dzierżawy.

  • Aktualizacja arkusza kalkulacyjnego po usunięciu użytkownika z dzierżawy.

Korzyści z używania webhooków

Webhooki umożliwiają integrację z innymi systemami w czasie rzeczywistym, eliminując potrzebę ciągłych ręcznych kontroli lub powtarzalnych żądań API. Poprzez nasłuchiwanie zdarzeń i natychmiastowe wysyłanie odpowiednich danych webhooki ograniczają zbędną pracę oraz umożliwiają płynną automatyzację.

Popularne platformy do integracji webhooków

W celu obsługi danych z webhooków oraz reagowania na nie, możesz budować niestandardowe usługi lub korzystać z platform firm zewnętrznych, takich jak:

Limity webhooków

W celu utrzymania wydajności systemu oraz zarządzania zasobami obowiązują następujące limity:

  • Historia dostarczania webhooków jest przechowywana przez 7 dni.

  • Każdy użytkownik może mieć maksimum 150 webhooków.

  • Na jedną dzierżawę można utworzyć maksimum 100 webhooków.

Struktura żądania webhooka

Gdy webhook zostanie wyzwolony przez zdarzenie, wysyła żądanie JSON do określonego punktu końcowego. Struktura tego żądania zawiera ważne szczegóły dotyczące zdarzenia, takie jak typ zdarzenia, znacznik czasu oraz inne metadane.

Przykład żądania webhooka: zdarzenie usunięcia aplikacji

Oto przykład żądania JSON wysyłanego, gdy zostanie usunięta aplikacja:

Adres URL żądania


https://api.blendr.io/v1/widgets/F502987A-AF89-4992-8127-F28794C5A74A?X-Execution-Token=xxxxx

Nagłówki


{
    "Content-Type": "application/json",
    "Qlik-Signature": "446bd5e3f5b635f491d17557e4bec6ebc61b7bd2bc9cc7b612e4e",
    "User-Agent": "Qlik Webhook"
}

Treść


{
    "cloudEventsVersion": "0.1",
    "source": "com.qlik/engine",
    "contentType": "application/json",
    "eventId": "e65c1481-e8a-4be-a5ca-27dfcde077d7",
    "eventTime": "2021-03-08T14:51:29Z",
    "eventTypeVersion": "1.0.0",
    "eventType": "com.qlik.v1.app.deleted",
    "extensions": {
        "ownerId": "vNRGrDZIypJzauw59BbpvkRhqbmI",
        "tenantId": "oZcMPa_1PwH4FUdrh6839YHHdEJN",
        "userId": "vNRGrDZIypJtcGTzauw59BbpqbmI"
    },
    "data": {
        "attributes": {
            "id": "0984fec4-aa8c-4253-b1d1-4fd4f9c78",
            "name": "New App",
            "createdDate": "2021-03-08T14:51:28.888Z",
            "modifiedDate": "2021-03-08T14:51:29.316Z",
            "owner": "auth0|b62a17c577a4abe6e807b07d18c4d82286352542d633d120100b03fb11",
            "ownerId": "vNRGrDZIypJtcGTzauw59BbpvbmI",
            "published": false,
            "hasSectionAccess": false
        }
    }
}

Ten ładunek dostarcza szczegółowych informacji o usuniętej aplikacji, takich jak jej identyfikator, nazwa, właściciel i znacznik czasu usunięcia, pomagając systemowi odbierającemu przetworzyć zdarzenie. Więcej informacji o ładunkach zdarzeń można znaleźć na stronie Qlik Developer Portal: API events.

Tworzenie webhooków

Webhooki mogą tworzyć:

  • Administratorzy dzierżawy z centrum aktywności Administrowanie.

  • Wszyscy użytkownicy z interfejsu Automatyzacji aplikacji Qlik.

Więcej informacji na temat korzystania z webhooków i Automatyzacji aplikacji można znaleźć w temacie Pracaz webhookami (tylko w języku angielskim).

Wykonaj następujące czynności:

  1. W centrum aktywności Administrowanie wybierz pozycję Elementy Webhook.

  2. Kliknij polecenie Utwórz nowe.

  3. Wprowadź nazwę webhooka oraz opcjonalny opis.

  4. W przypadku adresu URL (punktu końcowego) wprowadź w pełni kwalifikowaną nazwę domeny (FQDN), do której webhook będzie wysyłał dane JSON.

    • Ten adres URL musi używać protokołu HTTPS (przykład: https: //domena.com). Adresów IP nie można używać jako punktów końcowych webhooków.

  5. Opcjonalnie wprowadź klucz tajny do uwierzytelniania webhooka.

    • Klucz tajny musi składać się z 32–64 znaków.

    • Jeśli zostanie utworzony, klucz tajny zostanie uwzględniony jako część skrótu dołączanego do żądania HTTP jako qlik-signature.

  6. Opcjonalnie dodaj nagłówki HTTP do żądania.

  7. W sekcji Zdarzenia wybierz zdarzenia systemowe, które będą wyzwalać webhook. Dostępne zdarzenia obejmują:

    • Zdarzenia aplikacji: utworzono, usunięto, wyeksportowano, zaktualizowano (odświeżono) dane, opublikowano, przeładowano.

    • Zdarzenia użytkowników: utworzono, usunięto.

  8. Kliknij polecenie Utwórz.

Zarządzanie elementami webhook

Filtrowanie i wyszukiwanie webhooków

Sortowanie i wyszukiwanie webhooków w tabeli:

  • Kliknij Strzałka w górę/dół na górze kolumny, aby zmienić kolejność sortowania.

  • Kliknij Filtr u góry kolumny, aby wyszukać webhook. Filtr wyszukiwania działa w odniesieniu do pełnych i częściowych dopasowań.

Tabela Webhooki.

Tabela webhooków Konsoli zarządzania

Włączanie i wyłączanie webhooków

Wykonaj następujące czynności:

  1. W centrum aktywności Administrowanie wybierz pozycję Elementy Webhook.

  2. Kliknij Więcej obok webhooka.

  3. Aby włączyć webhook, wybierz Włącz element webhook.

  4. Aby wyłączyć webhook, wybierz Wyłącz element webhook.

Nowo utworzone webhooki są domyślnie włączone.

Edytowanie webhooków

Wykonaj następujące czynności:

  1. W centrum aktywności Administrowanie wybierz pozycję Elementy Webhook.

  2. Kliknij Więcej przy webhooku do edycji.

  3. Wybierz Edytuj.

  4. Wprowadź żądane zmiany i kliknij Zapisz.

Usuwanie webhooków

Wykonaj następujące czynności:

  1. W centrum aktywności Administrowanie wybierz pozycję Elementy Webhook.

  2. Wybierz element webhook do usunięcia.

  3. Kliknij polecenie Usuń.

  4. Potwierdź usunięcie.

Przeglądanie historii webhooków

Historia zdarzeń webhooków jest przechowywana przez 7 dni.

Wykonaj następujące czynności:

  1. W centrum aktywności Administrowanie wybierz pozycję Elementy Webhook.

  2. Kliknij Ikona strzałki w dół w interfejsie do rozwijania menu elementu webhook obok webhooka, aby rozwinąć jego historię zdarzeń.

    Historia webhooków.

    Historia webhooków Konsoli zarządzania
  3. Aby ponownie wysłać ręcznie dostarczenie zdarzenia, kliknij przycisk Ikona Wyślij ponownie w wierszu zdarzenia.

  4. Aby wyświetlić ładunek reakcji na zdarzenie, kliknij przycisk Strzałka w dół na końcu wiersza zdarzenia.

    Ładunek pokazuje szczegóły, takie jak identyfikator aplikacji, nazwa i znacznik czasu, co się przydaje do debugowania lub audytu zdarzeń z przeszłości.

    Ładunek reakcji na zdarzenie.

    Informacje o ładunku typu zdarzeń elementu webhook Konsoli zarządzania

Czy ta strona była pomocna?

Jeżeli natkniesz się na problemy z tą stroną lub jej zawartością — literówkę, brakujący krok lub błąd techniczny — daj nam znać, co możemy poprawić!