Przejdź do treści
Biblioteka skilli
Programowanie · Integracja z narzędziem

using-webhooks

/using-webhooks

Wyjaśnia, jak działa dostęp do webhooków w aplikacjach Major i jak wdrożyć endpointy odbierające callbacki od usług, np. Stripe.

Repozytorium
cli ↗
Licencja
MIT
Ostatnia zmiana repozytorium
23.10.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
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

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

Licencja

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

Co robi i kiedy

Wyjaśnia, jak działa dostęp do webhooków w aplikacjach Major i jak wdrożyć endpointy odbierające callbacki od usług, np. Stripe.

Oryginalny opis (EN)

Explains how webhook access works on deployed Major apps and how to implement webhook endpoints. Use when the user mentions webhooks, needs to receive external HTTP callbacks, or is integrating with services that send webhooks (e.g., Stripe, GitHub, Twilio).

Jak działa

  1. Overview
  2. Two Options
  3. Checking & Enabling Webhooks
  4. Implementing Webhook Endpoints
  5. Tips
Sekcje z nagłówków SKILL.md, w oryginale · 81 linii, 552 słów
Podgląd SKILL.md
---
name: using-webhooks
description: Explains how webhook access works on deployed Major apps and how to implement webhook endpoints. Use when the user mentions webhooks, needs to receive external HTTP callbacks, or is integrating with services that send webhooks (e.g., Stripe, GitHub, Twilio).
---

# Major Platform: Webhooks

## Overview

Major apps are protected by an authentication gateway by default. Enabling **Webhook Access** allows unauthenticated HTTP traffic to reach routes matching `/api/webhook/*` on **deployed apps only**. This is required for receiving callbacks from external services like Stripe, GitHub, Twilio, etc.

**Important:** Webhook access simply allows traffic through — it does NOT perform any authentication or verification. If the webhook provider supports authentication (e.g., Stripe signature verification, GitHub webhook secrets, Twilio request validation), the application **MUST** implement its own verification at the application layer.

---

## Two Options

- **Webhook token (preferred):** for any sender that can set a URL or a header. This includes Zapier, internal services, scripts, and signing senders such as Stripe and GitHub, where the token adds a second layer. The sender sends the token as `x-major-jwt: <token>` or as `?major_token=<token>`. The token works only on the app it was created for, on both the deployed app and the preview.
- **Unauthenticated toggle:** for senders that cannot carry a token. The app must verify the provider signature, as described below.

### Where tokens are created

Major dashboard > open the app > Settings tab > Webhook Access > Webhook tokens > Create. Only app admins can create tokens. The agent never creates or sees a token. Tell the user to create one and to paste the URL (`https://<app-host>/api/webhook/<your-route>?major_token=<token>`) into the sender.

### App code with tokens

The request arrives as the token's creator in `x-major-user-id`. The app must not log full request URLs, because the query can contain `major_token`.

---

## Checking & Enabling Webhooks

Run `major app info --json` from the app workspace to check the current app status, including `webhooksEnabled`. In a hosted sandbox, run it through `mcp__plugin_major_major__sandbox_bash`.

If webhooks are not enabled, instruct the user to enable them from the **Major dashboard → App Settings → Webhook Access** toggle.

**Note:** If the app is already public (`isPublic: true`), webhook access is not needed — all unauthenticated traffic is already allowed.

---

## Implementing Webhook Endpoints

Create your webhook routes under the `/api/webhook/` path. Only routes matching this pattern will bypass authentication when webhook access is enabled.

```typescript
// app/api/webhook/stripe/route.ts
import { NextRequest, NextResponse } from "next/server";
import Stripe from "stripe";

const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!);
const webhookSecret = process.env.STRIPE_WEBHOOK_SECRET!;

export async function POST(request: NextRequest) {
	const body = await request.text();
	const signature = request.headers.get("stripe-signature")!;

	// CRITICAL: Verify the webhook signature at the application layer
	let event: Stripe.Event;
	try {
		event = stripe.webhooks.constructEvent(body, signature, webhookSecret);
	} catch (err) {
		return NextResponse.json({ error: "Invalid signature" }, { status: 400 });
	}

	// Handle the verified event
	switch (event.type) {
		case "checkout.session.completed":
			// Process the event
			break;
	}

	return NextResponse.json({ received: true });
}
```

---

## Tips

- **Deployed apps only** — Webhook bypass only applies to deployed applications, not coding sessions
- **Route pattern** — Only `/api/webhook/*` routes are bypassed. All other routes still require authentication
- **Always verify signatures** — Since Major does not authenticate webhook requests, you MUST verify request authenticity yourself using provider-specific mechanisms (signatures, shared secrets, etc.)
- **Public apps** — If the app is already public, the webhook toggle is irrelevant since all routes are already accessible without authentication
- **Environment variables** — Store webhook secrets (e.g., `STRIPE_WEBHOOK_SECRET`, `GITHUB_WEBHOOK_SECRET`) as environment variables in the Major dashboard

Wersje

W bazie nie ma innych skilli o nazwie using-webhooks.

Migawka bazy z 13.11.2026 · wersja paczki aa2205813be0 (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

  • 100twilio-webhooks
    Odbiera i weryfikuje webhooki Twilio, w tym podpis X-Twilio-Signature, SMS przychodzące, połączenia głosowe oraz callbacki statusu wiadomości i nagrań.
  • 100stripe-webhooks
    Odbiera i weryfikuje webhooki Stripe, w tym podpisy, oraz obsługuje zdarzenia płatności, takie jak payment_intent.succeeded, customer.subscription.created czy invoice.paid.
  • 100webhook-collector
    Tworzy endpointy webhooków, wysyła testowe ładunki i sprawdza przechwycone zdarzenia w webhookcollector.dev.
  • 100webhooks
    Obejmuje wzorce wysyłania i odbierania webhooków: weryfikacja podpisu, ponowienia, idempotencja, projekt payloadu i infrastruktura, z konsumpcją webhooków Stripe, GitHub i Slack oraz własną wysyłką.
  • 100stripe-test-cards-and-webhooks
    Testuje płatności Stripe w trybie testowym: karty testowe, przekazywanie webhooków lokalnie i weryfikację podpisu.
  • 100receive-webhooks
    Odbiera i weryfikuje webhooki od dostawców, na przykład Stripe, GitHub, Twilio czy Slack, i przekazuje je do prywatnej usługi bez jej wystawiania w internecie.

Uwagi i zgłoszenia

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