Dokümantasyon

Secret sıfırla

Kullanıcının mevcut secret'ını tamamen siler. Frozen durumu, reject sayacı ve cihaz bağlantısı dahil her şey temizlenir. Yanıt, QR görseliyle yeni bir secret ve 10 yeni kurtarma kodu taşır (5 dakika geçerli): kullanıcı telefonunu bununla yeniden bağlar.

POST/auth/secret/reset
Gövde parametreleri
ParametreTipAçıklama
externalUsernamestringSizin user ID Zorunlu
Dikkat: Bu işlem geri alınamaz. Eski secret artık geçersiz olur.
Frozen çözme: Kullanıcı çok fazla reddedip 2FA dondurulduysa, reset ile frozen durumu da temizlenir.
İstek
const { Touchque } = require('@touchque/node');

const tq = new Touchque({
  apiKey: 'tq_abc123',
  apiSecret: 'YOUR_API_SECRET'
});

async function resetDevice() {
  // Kullanıcının mevcut secretını kalıcı olarak siler ve yenisini döndürür
  const reset = await tq.auth.resetSecret({
    externalUsername: 'user@yourcompany.com'
  });

  // reset = { secret, qrCodeDataUrl, recoveryCodes, expiresAt, externalUsername }
  // Yeni secret 5 dk geçerli: telefonu reset.qrCodeDataUrl ile yeniden bağlayın
  console.log('Yeni secret:', reset.secret);
}

resetDevice();
Cevap 200
{
  "success": true,
  "secret": "A1B2C3D4E5F6A7B8C9D0E1F2",
  "qrCodeDataUrl": "data:image/png;base64,…",
  "externalUsername": "user@yourcompany.com",
  "message": "Secret reset successfully",
  "expiresAt": "2026-11-02T12:05:00.000Z",
  "recoveryCodes": ["…", "…"]
}