INTEGRITY Dokumentace

← Vytvářejte agenty na Cloudflare / agents / tools / payments / x402

Zpoplatnění obsahu HTTP

Šablona x402-proxy je Cloudflare Worker, který stojí před libovolným HTTP backendem. Když požadavek dorazí na chráněnou trasu, proxy vrátí odpověď 402 s pokyny k platbě. Poté, co klient zaplatí, proxy platbu ověří a přepošle požadavek na váš origin server.

Nasaďte šablonu x402-proxy do svého účtu Cloudflare:

Deploy to Cloudflare

Předpoklady

Konfigurace

Definujte chráněné trasy v wrangler.jsonc:

{
	"vars": {
		"PAY_TO": "0xYourWalletAddress",
		"NETWORK": "base-sepolia",
		"PROTECTED_PATTERNS": [
			{
				"pattern": "/api/premium/*",
				"price": "$0.10",
				"description": "Premium API access"
			}
		]
	}
}

Selektivní řízení přístupu pomocí Bot Management

S Bot Management, proxy může prohledávačům účtovat poplatek, zatímco web zůstane pro lidi zdarma:

{
	"pattern": "/content/*",
	"price": "$0.10",
	"description": "Content access",
	"bot_score_threshold": 30,
	"except_detection_ids": [117479730]
}

Požadavky se skóre bota na úrovni nebo pod bot_score_threshold jsou přesměrováni na paywall. Použijte except_detection_ids pro povolení konkrétních crawlerů podle ID detekce.

Nasadit

Naklonujte šablonu, upravte wrangler.jsonc, a nasaďte:

git clone https://github.com/cloudflare/templates
cd templates/x402-proxy-template
npm install
npx wrangler deploy

Úplné možnosti konfigurace a příklady Bot Management najdete v šablona README ↗.

Vlastní koncové body Workeru

Pro větší kontrolu přidejte middleware x402 přímo do svého Workeru pomocí Hono:

import { Hono } from "hono";
import { paymentMiddleware } from "x402-hono";

const app = new Hono<{ Bindings: Env }>();

app.use(
	paymentMiddleware(
		"0xYourWalletAddress" as `0x${string}`,
		{
			"/premium": {
				price: "$0.10",
				network: "base-sepolia",
				config: { description: "Premium content" },
			},
		},
		{ url: "https://x402.org/facilitator" },
	),
);

app.get("/premium", (c) => c.json({ message: "Thanks for paying!" }));

export default app;

Viz Příklad x402 pro Workers ↗ pro kompletní implementaci.