Dokümantasyon

Giriş isteği

Kullanıcı giriş yapmak istediğinde backend'inizden çağırın. Touchque push bildirim gönderir.

POST/login/request
Gövde parametreleri
ParametreTipVarsayılanAçıklama
externalUsernamestring—Kullanıcı ID Zorunlu
typestring"LOGIN"Örn: "LOGIN", "TRANSFER", "PAYMENT": çalışma alanınızda tanımlı bir işlem türü (bkz. İşlem türleri), yoksa yanıt 400 unknown_action olur. AI Risk Motoru string isminden anlamsal risk analizi yapar. Opsiyonel
referenceIdstringnullSizin takip no Opsiyonel
browserProofstringnullSessiz giriş: tarayıcının X-Touchque-Browser kanıtı, olduğu gibi iletilir. Bu istek telefonda onaylanınca Touchque tarayıcıyı tanır. Opsiyonel
Giriş isteği 30 saniye geçerlidir. Süre dolunca EXPIRED olur.
"Neden?" vaka kodu. Her yanıt caseCode taşır (örn. K7P-2QX): 200 ve her ret (403 blocked ve device_keys_lost, 423 frozen, 429 rate_limited). Bir istek reddedildiğinde ya da sayı eşleştirme istediğinde kodu kullanıcıya gösterin ("Destek ekibinize söyleyin: K7P-2QX"). Ekibiniz kararı bu panelde Logs → Look up a case altında açar: nedenler, her kontrol ve neyin geçireceği. Sayı eşleştirme ya da passkey yanıtı ayrıca sade reasons [{ code, text }] taşır.
İstek
const { Touchque } = require('@touchque/node');

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

async function loginUser() {
  // Sadece istek atmak isterseniz (Callback kullanıyorsanız):
  const request = await tq.login.request({
    externalUsername: 'user@yourcompany.com',
    type: 'LOGIN'
  });
  console.log('Request ID:', request.requestId);

  // ALTERNATİF: Tek satırda hem istek atıp hem onayı beklemek için (Polling):
  /*
  try {
    const result = await tq.login.verify({
      externalUsername: 'user@yourcompany.com',
      type: 'LOGIN',
      timeout: 30000,
      // Numara eşleştirme: numarayı şimdi gösterin, telefon onu soruyor
      onChallenge: ({ challengeCode }) => { if (challengeCode) console.log('Pick', challengeCode, 'on your phone'); }
    });
    console.log('User approved!');
  } catch (err) {
    console.log('User rejected or timeout:', err.message);
  }
  */
}

loginUser();
Cevap 200
{
  "message": "Request sent",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "caseCode": "K7P-2QX"
}