Rekisteröi vain tarvitsemasi tapahtumat
Luo päätepistePOST /v3/webhooks -toiminnolla. Tilaa vain dokumentoituja tapahtumia, jotka ohjaavat integraatiotasi. Tämä esimerkki käyttää transfer.state_changed -tapahtumaa.
data.id muuttujaan WEBHOOK_ID. Avaa GET /v3/webhooks/portal -toiminnon palauttama portaali, hae tämän päätepisteen allekirjoitussalaisuus ja tallenna se erillään API-avaimestasi salaisuudenhallintaan.
Vahvista ennen jäsennystä
Swipelux toimittaa uudet webhook-integraatiot Svixin kautta. Vahvista raaka pyyntörunko päätepisteesi allekirjoitussalaisuudella ja näillä otsakkeilla:svix-idsvix-timestampsvix-signature
Tallenna, kuittaa, sitten käsittele
Aseta yksilöllisyysrajoite kirjekuorenid-kentälle. Tallenna vahvistettu kirjekuori, palauta 2xx nopeasti, käsittele se sitten asynkronisesti.
Jos tapahtuman ID on jo olemassa, kuittaa toimitus toistamatta valmiita sivuvaikutuksia. Jatka odottavaa tai epäonnistunutta paikallista työtä oman uudelleenyritysjonosi kautta. Älä käytä kirjekuoren attempt-kenttää deduplikointiavaimena tai kuljetuksen uudelleenyrityslaskurina.
Hae nykyinen tila uudelleen
Webhookin järjestys ei ole arvovaltainen resurssihistoria. Käytäresource.type- ja resource.id-arvoja objektin paikantamiseen, hae sitten sen nykyinen tila ennen järjestelmäsi päivittämistä.
Siirtotapahtumassa kutsu GET /v3/transfers/{transferId}:
Palauta toimitukset
KäytäGET /v3/webhooks/portal -toimintoa avataksesi toimituslokit, uudelleenyrittääksesi epäonnistuneet toimitukset tai aloittaaksesi manuaalisen toiston.
Jokaisen toiston täytyy kulkea saman allekirjoitusvahvistuksen ja kestävän saapumislaatikon läpi. Toipuaksesi katkoksen jälkeen toista vaikuttava ikkuna ja hae kukin viitattu resurssi uudelleen. Valmiit tapahtuma-ID:t pysyvät tekemättöminä; keskeneräiset tietueet jatkuvat asynkronisesti.
Seuraavaksi vahvista päällekkäiset ja epäjärjestyksessä olevat toimitukset sandboxissa, suorita sitten Käynnistys tuotantoon -tarkistuslista.