2FA CUY — API Documentation

2FA CUY Instant TOTP API

Expose generator kode OTP secara programatis melalui Rest API. Developer dapat mengintegrasikan pembuatan kode TOTP (Time-based One-time Password) langsung ke dalam script otomatisasi, bot chat (seperti Telegram/Discord), atau tools development lainnya tanpa perlu menghitung TOTP secara manual.

Endpoint API

Untuk mendapatkan kode OTP terbaru berdasarkan kunci rahasia Base32, kirim HTTP request GET ke endpoint berikut:

GET https://2facuy.app/api/otp

Query Parameters

Parameter	Tipe	Kewajiban	Deskripsi
secret atau key	string	Required	Kunci rahasia Base32 (misal: JZB33LXFU4XZZOFT). Mendukung spasi dan tanda minus.

Response Schema (200 OK)

{
  "ok": true,
  "code": "184406",
  "remaining": 27
}

Response Schema (400 Bad Request)

{
  "ok": false,
  "error": "Invalid Base32 secret key format"
}

Interactive Playground

Coba panggil API ini secara langsung untuk menguji respon kembalian.

JSON RESPONSE

Klik "Test API" untuk memanggil endpoint...

Code Templates

Salin snippet di bawah ini untuk berintegrasi cepat di bahasa pemrograman pilihan Anda.

curl "https://2facuy.app/api/otp?secret=JZB33LXFU4XZZOFT"