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 kojeg prilagođenog konektora — pogledajte Referencu konektora za potpuni, trenutni popis koji okidači konektora su anketiranje naspram webhook.

Pronalaženje vašeg webhook URL-a

Nakon što se radni tijek s korakom okidača u webhook načinu rada aktivira, kartica tog koraka prikazuje stvaran, jedinstven URL — kopirajte ga odande. Prikazuje se tek nakon aktivacije, jer se URL (i njegov sigurnosni token) generira u trenutku aktivacije, 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 konektora

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

Pozivanje pomoću curl-a

URL koji kopirate s aktiviranog koraka okidača 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 konektora, 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 radnog tijeka za rezultat. Prazno tijelo zahtjeva odbacuje se bez izrade izvršavanja, umjesto pogreške.