Webhookovi

Okidač u webhook načinu rada aktivira se u trenutku izvornog događaja, umjesto čekanja sljedeće provjere anketiranjem. Trenutno na ovaj način rade Stripeov okidač Događaj plaćanja i dolazni okidač bilo koje prilagođene aplikacije — pogledajte Integracije za potpuni, trenutni popis koji su okidači anketiranje naspram webhook.

Pronalaženje vašeg webhook URL-a

Nakon što je robot s korakom okidača u webhook načinu rada na poslu, kartica tog koraka prikazuje stvaran, jedinstven URL — kopirajte ga odande. Prikazuje se tek nakon što je robot poslan na posao, jer se URL (i njegov sigurnosni token) generira u tom trenutku, a ne kad je korak prvi put izrađen.

Sigurnosni model

Svaki webhook URL ugrađuje dug, neprobojiv nasumični token izravno u putanju — taj token je vjerodajnica. Nema ničega za konfigurirati osim umetanja URL-a tamo gdje pružatelj usluge (ili vaš vlastiti sustav) traži webhook krajnju točku. Stripe dodatno podržava tajni ključ za potpisivanje, unesen prilikom povezivanja Stripea, koji Gate97 koristi za provjeru da je svaki događaj stvarno stigao od Stripea prije reagiranja na njega — postavite ovo ako želite tu dodatnu provjeru; bez nje, događaji se i dalje prihvaćaju, samo neprovjereni.

Kako funkcionira isporuka

Gate97 odmah potvrđuje webhook zahtjev i obrađuje ga u pozadini, tako da pružatelj usluge nikad ne čeka na isteko vremena. Prihvaćaju se i POST i PUT. Duplicirane isporuke (pružatelji usluga često ponavljaju ako ne dobiju dovoljno brz odgovor) otkrivaju se i proizvode samo jedno izvršavanje.

Dolazni webhookovi prilagođenih aplikacija

Prilagođena aplikacija s omogućenim Podržava dolazni okidač funkcionira na potpuno isti način — njezin korak okidača dobiva stvaran webhook URL nakon što je robot na poslu, a sve što tamo pošaljete parsira se prema konfiguriranom formatu (JSON, XML, CSV ili obični tekst) i postaje dostupno ostatku robota kao {{trigger.*}}. Ovo je mehanizam kojim vaši vlastiti sustavi guraju podatke u Gate97, umjesto da ih Gate97 anketira. Pogledajte Prilagođene aplikacije kako postaviti jednu.

Pozivanje pomoću curl-a

URL koji kopirate s koraka okidača na robotu koji je na poslu već ima točan oblik prikazan ispod — ništa ne morate sami popuniti. Nekoliko razrađenih primjera, po jedan za svaki podržani format:

JSON (zadano — okidač konfiguriran za json):

curl -X POST "https://gate97.com/api/webhooks/custom:3f2a1b4c-9d21-4e3f-8a6b-1c2d3e4f5a6b/8f3e9c2a1b4d5e6f7a8b9c0d1e2f3a4b" \
  -H "Content-Type: application/json" \
  -d '{"orderId": "1234", "status": "paid"}'

PUT funkcionira identično — obje metode prihvaćaju se na istom URL-u:

curl -X PUT "https://gate97.com/api/webhooks/custom:3f2a1b4c-9d21-4e3f-8a6b-1c2d3e4f5a6b/8f3e9c2a1b4d5e6f7a8b9c0d1e2f3a4b" \
  -H "Content-Type: application/json" \
  -d '{"orderId": "1234", "status": "shipped"}'

XML (okidač konfiguriran za xml):

curl -X POST "https://gate97.com/api/webhooks/custom:3f2a1b4c-9d21-4e3f-8a6b-1c2d3e4f5a6b/8f3e9c2a1b4d5e6f7a8b9c0d1e2f3a4b" \
  -H "Content-Type: application/xml" \
  -d '<order><id>1234</id><status>paid</status></order>'

CSV (okidač konfiguriran za csv) — svaki redak postaje vlastito izvršavanje, sa stupcima tog retka dostupnima kao {{trigger.*}}:

curl -X POST "https://gate97.com/api/webhooks/custom:3f2a1b4c-9d21-4e3f-8a6b-1c2d3e4f5a6b/8f3e9c2a1b4d5e6f7a8b9c0d1e2f3a4b" \
  -H "Content-Type: text/csv" \
  --data-binary $'name,email\nJane Doe,jane@example.com\nJohn Smith,john@example.com'

Header Content-Type iznad služi čitljivosti — Gate97 uvijek parsira tijelo koristeći format koji ste odabrali pri definiranju prilagođene aplikacije, bez obzira koji header pošiljatelj eventualno postavi. Uspješan poziv odmah dobiva brz, prazan 200 odgovor; samo izvršavanje odvija se u pozadini; provjerite povijest izvršavanja tog robota za rezultat. Prazno tijelo zahtjeva odbacuje se bez izrade izvršavanja, umjesto pogreške.