Zum Inhalt springen
POST AI agent ready /v1/totp/validate

TOTP Validate API – Kostenloser 2FA-Code-Verifizierer

Überprüfen Sie, ob ein TOTP-Code für ein bestimmtes gemeinsames Geheimnis gültig ist. Unterstützt ein konfigurierbares Zeitfenster, um Zeitversatz zwischen Client und Server zu berücksichtigen.

Parameters

stringrequired

The TOTP code to validate.

stringrequired

The Base32-encoded shared secret.

number

Time step in seconds.

number

Number of periods before and after the current one to accept (for clock skew).

Code examples

curl -X POST https://api.botoi.com/v1/totp/validate \
  -H "Content-Type: application/json" \
  -d '{"code":"482937","secret":"JBSWY3DPEHPK3PXP","period":30,"window":1}'

When to use this API

Login-2FA-Verifizierung

Nachdem ein Benutzer beim Anmelden seinen TOTP-Code eingegeben hat, validieren Sie ihn serverseitig anhand seines gespeicherten Geheimnisses, bevor Sie Zugriff gewähren.

Automatisierte Sicherheitstests

Generieren und validieren Sie TOTP-Codes in Integrationstests, um zu überprüfen, dass Ihre 2FA-Middleware abgelaufene oder falsche Codes ablehnt.

Frequently asked questions

Was bedeutet der Driftwert?
Drift gibt den Zeitschrittversatz an, bei dem der Code übereinstimmte. 0 bedeutet die aktuelle Periode, -1 bedeutet die vorherige Periode und 1 bedeutet die nächste Periode.
Welchen Fensterwert sollte ich verwenden?
Ein Fenster von 1 (Standardeinstellung) lässt Codes aus dem vorherigen und nächsten 30-Sekunden-Fenster zu, was den typischen Zeitversatz verursacht. Für eine mildere Validierung auf 2 erhöhen.
Können abgelaufene Codes die Validierung bestehen?
Es passieren nur Codes innerhalb des Zeitfensters. Ein Fenster von 1 akzeptiert Codes, die bis zu 30 Sekunden alt sind. Ältere Codes werden abgelehnt.
Ist ein Wiedergabeschutz enthalten?
Nein. Die API führt eine zustandslose Validierung durch. Um Replay-Angriffe zu verhindern, verfolgen Sie verwendete Codes auf Ihrem Server und lehnen Sie Duplikate ab.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.