GET /v1/totpTOTP generate & verify
Security Utils lf-security-utils
Makes or checks the short codes that authenticator apps show and that change over time. Generates and verifies Time-based One-Time Passwords (RFC 6238) from a Base32-encoded secret key.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
secret | string | Yes | Base32-encoded secret |
mode | string | No | generate or verify |
code | string | No | Code to verify |
digits | integer | No | 6/7/8 digits |
period | integer | No | Time step (seconds) |
Response Schema
success (boolean): Operation success
code (string): Generated TOTP code
remaining (integer): Seconds remaining
valid (boolean): Verification result
cURL Example
curl 'https://lf-security-utils.laminarforge.dev/v1/totp?secret=JBSWY3DPEHPK3PXP&mode=generate' -H 'Authorization: Bearer lf_YourApiKey'
Python Example
import requests
url = 'https://lf-security-utils.laminarforge.dev/v1/totp'
headers = {'Authorization': 'Bearer lf_YourApiKey'}
params = {'secret': 'JBSWY3DPEHPK3PXP', 'mode': 'generate'}
response = requests.get(url, headers=headers, params=params)
print(response.json())