Autorisierung

Die x402-API kennt keine Konten, Passwörter oder API-Schlüssel. Stattdessen werden drei Arten von Nachweisen verwendet: die Zahlungssignatur, das Zugriffstoken der Bestellung und die Wallet-Signatur.

Geben Sie Ihre Zugriffstoken nicht an Dritte weiter und senden Sie den privaten Schlüssel Ihrer Wallet niemals an irgendjemanden, auch nicht an uns.

Wichtigste Merkmale

Zahlungssignatur

Die Wallet, über die die Zahlung erfolgt, gehört dem Käufer. Bei der ersten erfolgreichen Zahlung wird automatisch ein Wallet-Konto erstellt; eine Registrierung ist nicht erforderlich. Verlängerungen und der inländische Datenverkehr einer Bestellung können nur über die Wallet bezahlt werden, mit der die Bestellung bezahlt wurde.

Zugriffstoken

Jeder bezahlte Auftrag liefert ein access_token einmal, im 202 Antwort. Senden Sie diese im Authorization Kopfzeile bei jeder Anfrage zu diesem Auftrag: Status und Zugangsdaten, Verlängerung, Datenverkehr, Einstellungen, IP-Ersetzung und Ereignisse.

Wallet-Signatur

Um neue Token für Ihre Bestellungen zu erhalten oder Ihr Guthaben abzuheben, signieren Sie eine einmalige SMS (EIP-4361) mit derselben Wallet. Durch das Signieren werden keine Gelder bewegt.

Zugriffstoken

Authorization: Bearer x402_q8Zt3Lw0mN6pR2vY9cK4hJ7sD1fG5bX8aE3uW0iO2nT

Eigenschaft	Wert
Format	`x402_` gefolgt von 43 Zeichen. Das Wort `Bearer` Die Groß-/Kleinschreibung spielt keine Rolle
Wo	Nur im `Authorization` Header. Tokens in der Abfragezeichenfolge werden nicht akzeptiert
Umfang	Ein Auftrag: `/orders/{id}` sowie dessen Unterressourcen, einschließlich der Verlängerung und des Datenverkehrs dieser Bestellung. Ein Aufladetoken öffnet nur `GET /topup/{id}`
Erteilt	Einmal pro Vorgang, im `202` Antwort. Wird dieselbe signierte Anfrage innerhalb von 24 Stunden wiederholt, wird dasselbe Token zurückgegeben. Danach werden neue Token nur noch von Zugriff wiederherstellen
Lebensdauer	Bis zum Ablaufdatum des Auftrags plus 90 Tage; Verlängerungen verlängern diese Frist. Bei einem Vorgang ohne Ablaufdatum gelten 90 Tage nach Erreichen des endgültigen Status.
Widerruf	Sperrung des Wallets, `revoke_existing` in Zugriff wiederherstellenoder Unterstützung auf Anfrage

Neue Token heben alte nicht auf: Jeder gültige Token einer Bestellung bleibt weiterhin gültig.

Fehler

Antwort	Wenn
`401 unauthorized`	Das `Authorization` Die Überschrift fehlt oder ist nicht `Bearer x402_…`
`404 order_not_found`	Sonstige Probleme: Der Auftrag existiert nicht, das Token gehört zu einem anderen Auftrag, das Token wurde widerrufen oder ist abgelaufen. Die API unterscheidet nicht zwischen diesen Fällen.

Beispiel

401: Nicht autorisiert

{
    "error": "unauthorized",
    "message": "Authorization is required",
    "retryable": false,
    "retry_action": "abandon",
    "detail": "Authorization: Bearer <access_token> from the order response is required"
}

Verlorenes Token

Sollte das Token verloren gehen, stellen Sie den Zugriff über Ihre Wallet wieder her: Zugriff wiederherstellen. Die Antwort listet alle Bestellungen der Wallet mit neuen Tokens auf.

Wichtigste Merkmale

Zahlungssignatur

Zugriffstoken

Wallet-Signatur

Zugriffstoken

Fehler

Beispiel

Verlorenes Token

On this page