Przejdź do treści
Biblioteka skilli
Finanse i księgowość · Integracja z narzędziem

root-platform-webhooks

/root-platform-webhooks

Odbiera i weryfikuje webhooki Root, sprawdza podpis x-hook-signature-256 i obsługuje zdarzenia polisy oraz zgłoszenia szkód.

Repozytorium
webhook-skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
25
Skrypty
8
Komentarze HTML
0
Adresy URL w SKILL.md
12
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 8 skryptów w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: examples/express/src/index.js, examples/express/test/webhook.test.js, examples/fastapi/main.py, examples/fastapi/test_webhook.py, examples/nextjs/app/lib/webhook.ts, examples/nextjs/app/webhooks/root-platform/route.ts, examples/nextjs/test/webhook.test.ts, examples/nextjs/vitest.config.ts

Co robi i kiedy

Odbiera i weryfikuje webhooki Root, sprawdza podpis x-hook-signature-256 i obsługuje zdarzenia polisy oraz zgłoszenia szkód.

Oryginalny opis (EN)

Receive and verify Root webhooks. Use when configuring Root webhook endpoints, debugging x-hook-signature-256 signatures, or handling policyholder_created, policy_issued, claim_opened.

Jak działa

  1. When to Use This Skill
  2. Setup
  3. Verification (core)
  4. Event Handling
  5. Local Development
  6. Resources
  7. Recommended: webhook-handler-patterns
  8. Related Skills
Sekcje z nagłówków SKILL.md, w oryginale · 68 linii, 343 słów
Podgląd SKILL.md
---
name: root-platform-webhooks
description: >
  Receive and verify Root webhooks. Use when configuring Root webhook
  endpoints, debugging x-hook-signature-256 signatures, or handling policyholder_created, policy_issued, claim_opened.
license: MIT
metadata:
  author: hookdeck
  version: "0.1.0"
  repository: https://github.com/hookdeck/webhook-skills
---

# Root Webhooks

Receive Root insurance policy, policyholder and claim events.

## When to Use This Skill

- Configure a receiver for Root webhook deliveries.
- Diagnose `x-hook-signature-256` verification failures.
- Handle `policyholder_created`, `policy_issued`, `claim_opened`.

## Setup

Create a webhook through Root's API for the organisation and environment, with the required subscriptions. Save the secret returned by the create response. A separately chosen verification_token is echoed in the body and does not replace signature verification.

Set `ROOT_PLATFORM_WEBHOOK_SECRET` in the server environment. Read [setup](references/setup.md) before enabling delivery.

## Verification (core)

`x-hook-signature-256` contains a bare hex digest over the raw body. Use HMAC-SHA256 with the secret's UTF-8 bytes. Verify the original bytes before parsing JSON. Validate the digest format, then compare equal-length buffers in constant time.

After extracting the documented digest and constructing `message` as described in [verification](references/verification.md), the comparison is:

```javascript
const expected = crypto.createHmac('sha256', secret).update(message).digest();
if (digest.length !== 64 || !/^[0-9a-fA-F]{64}$/.test(digest)) return false;
const received = Buffer.from(digest, 'hex');
return received.length === expected.length && crypto.timingSafeEqual(received, expected);
```

No timestamp is included in the signed message. These examples do not invent an age check from unsigned fields.

Complete handlers and tests: [Express](examples/express/), [Next.js](examples/nextjs/), [FastAPI](examples/fastapi/).

## Event Handling

Event deliveries carry event.type. Notification deliveries carry notification instead and may have no event type. Verify X-Hook-Signature-256; the older X-Hook-Signature uses deprecated SHA-1.

Return 2xx within 30 seconds and keep handlers fast. Acknowledge notification payloads you do not process, and make event handling idempotent.

## Local Development

```bash
npx hookdeck-cli listen 3000 root-platform --path /webhooks/root-platform
```

Use port 8000 for FastAPI. The CLI provides a local tunnel and inspection UI; no account is required to start.

## Resources

- [Overview and event routing](references/overview.md)
- [Endpoint and secret setup](references/setup.md)
- [Verification and troubleshooting](references/verification.md)

## Recommended: webhook-handler-patterns

Use the patterns skill for [handler sequence](https://github.com/hookdeck/webhook-skills/blob/main/skills/webhook-handler-patterns/references/handler-sequence.md), [idempotency](https://github.com/hookdeck/webhook-skills/blob/main/skills/webhook-handler-patterns/references/idempotency.md), [error handling](https://github.com/hookdeck/webhook-skills/blob/main/skills/webhook-handler-patterns/references/error-handling.md) and [retry logic](https://github.com/hookdeck/webhook-skills/blob/main/skills/webhook-handler-patterns/references/retry-logic.md).

## Related Skills

- [stripe-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/stripe-webhooks): another HMAC receiver.
- [github-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/github-webhooks): another HMAC receiver.
- [shopify-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/shopify-webhooks): another HMAC receiver.
- [gitbook-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/gitbook-webhooks): another HMAC receiver.
- [preczn-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/preczn-webhooks): another HMAC receiver.
- [webhook-handler-patterns](https://github.com/hookdeck/webhook-skills/tree/main/skills/webhook-handler-patterns): delivery and processing patterns.
- [hookdeck-event-gateway](https://github.com/hookdeck/webhook-skills/tree/main/skills/hookdeck-event-gateway): managed delivery and inspection.
Pliki w paczce (25)
  • SKILL.md 4 KB
  • examples/express/.env.example 1 KB
  • examples/express/README.md 2 KB
  • examples/express/package.json 1 KB
  • examples/express/vector.json 1 KB
  • examples/express/src/index.js 3 KB
  • examples/express/test/webhook.test.js 6 KB
  • examples/fastapi/.env.example 1 KB
  • examples/fastapi/README.md 2 KB
  • examples/fastapi/main.py 2 KB
  • examples/fastapi/requirements.txt 1 KB
  • examples/fastapi/test_webhook.py 6 KB
  • examples/fastapi/vector.json 1 KB
  • examples/nextjs/.env.example 1 KB
  • examples/nextjs/README.md 2 KB
  • examples/nextjs/package.json 1 KB
  • examples/nextjs/tsconfig.json 1 KB
  • examples/nextjs/vector.json 1 KB
  • examples/nextjs/vitest.config.ts 1 KB
  • examples/nextjs/app/lib/webhook.ts 2 KB
  • examples/nextjs/app/webhooks/root-platform/route.ts 1 KB
  • examples/nextjs/test/webhook.test.ts 6 KB
  • references/overview.md 1 KB
  • references/setup.md 1 KB
  • references/verification.md 2 KB

Wersje

W bazie nie ma innych skilli o nazwie root-platform-webhooks.

Migawka bazy z 13.11.2026 · wersja paczki cb1467473b65 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100preczn-webhooks
    Odbiera i weryfikuje webhooki Preczn: konfiguruje endpoint, sprawdza podpis x-preczn-signature i obsługuje zdarzenia transakcji.
  • 100mautic-webhooks
    Odbiera i weryfikuje webhooki Mautic, w tym podpis Webhook-Signature, oraz obsługuje zdarzenia takie jak mautic.lead_post_save_new, mautic.form_on_submit i mautic.email_on_open.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.