DOCS

Webhooki

Słuchaj zdarzeń za pośrednictwem webhooków

Otrzymuj powiadomienia o zdarzeniach w czasie rzeczywistym dla twojej integracji Zonos.

Webhooki umożliwiają Zonosowi proaktywnie powiadamiać twoje systemy zewnętrzne, gdy następują określone zdarzenia. Gdy zarejestrowane zdarzenie miałoby miejsce, Zonos wyśle żądanie HTTP POST na adres URL webhoka, który określisz. Treść żądania będzie zawierać szczegóły zdarzenia, umożliwiając twoim systemom obsługę zdarzenia programowo.

Webhooki są przydatne do integracji Zonosa z innymi platformami, wyzwalania zautomatyzowanych przepływów pracy i utrzymywania synchronizacji danych w systemach w czasie rzeczywistym. Na przykład możesz użyć webhooków do:

  • Aktualizacji systemu zarządzania zamówieniami, gdy zamówienie zostanie utworzone w Zonosie
  • Powiadomienia dostawcy realizacji, gdy wysyłka zostanie anulowana
  • Logowania zmian statusu zamówień międzynarodowych w celach audytu

Typy webhooków 

Wszystkie dostępne typy webhooków są zawarte w wyliczeniu WebhookType. Przykładowe ładunki dla każdego można znaleźć w naszym przewodniku Typy zdarzeń.

Tworzenie webhooków 

Aby utworzyć webhook za pośrednictwem API:

1mutation WebhookCreate($input: WebhookCreateInput!) {
2 webhookCreate(input: $input) {
3 id
4 url
5 type
6 status
7 }
8}

Edytuj szczegóły webhoka 

Aby edytować istniejący webhook za pośrednictwem API:

1mutation WebhookUpdate($input: WebhookUpdateInput!) {
2 webhookUpdate(input: $input) {
3 id
4 url
5 type
6 status
7 }
8}

Wyświetl dzienniki webhooków 

Aby wyświetlić dzienniki webhooków za pośrednictwem API:

1query WebhookLogs(
2$first: Int
3$after: String
4$filter: WebhookLogsFilterInput
5) {
6 webhookLogs(first: $first, after: $after, filter: $filter) {
7 edges {
8 node {
9 id
10 type
11 url
12 createdAt
13 responseStatus
14 }
15 }
16 }
17}
GraphQL API ReferenceTypes, inputs, and operations used in this guide

Czy ta strona była pomocna?