Udalosti

V RoundlyConsulting\Webhooks\Events, všetky final readonly; žiadna nenesie tajný kľúč, podpis ani surové telo. Audit môžete zapisovať priamo z nich:

Neznáme kľúče nevyvolajú nič, takže cudzí nemôže zahlcovať vaše listenery; duplicita nevyvolá nič.

Raz na pokus — WebhookReceived

WebhookReceived sa vyvolá pri každom pokuse behu — handler, ktorý vyhodí výnimku, sa opakuje a opakovanie udalosť vyvolá znova. Listener, ktorý má konať raz na doručenie, skontroluje pokus:

Event::listen(function (WebhookReceived $event): void {
    if (! $event->webhook->isFirstAttempt()) {
        return;   // a retry of a run whose handler threw
    }

    Cache::increment('webhooks.received.'.$event->webhook->type);
});

Listenery vo fronte

WebhookProcessingFailed, DeliverySucceeded, DeliveryFailed, EndpointDisabled a EndpointSecretRotated používajú SerializesModels: listener ShouldQueue dostane modely v stave, v akom sú pri jeho spustení. WebhookReceived nesie sanitizovaný obsah a listener vo fronte by ho zapísal do úložiska frontu nešifrovaný, mimo payloads.encrypt. Listenery na WebhookReceived nechajte synchrónne, alebo do frontu pošlite len id doručenia a doručenie načítajte v jobe:

Event::listen(function (WebhookReceived $event): void {
    SyncInvoice::dispatch($event->webhook->deliveryId);   // the job loads it again
});

// in SyncInvoice::handle()
$delivery = Webhooks::inbound()->deliveries()->where('public_id', $this->deliveryId)->firstOrFail();