Dokümantasyon

Onayı kullan

Onaylanmış bir isteği atomik olarak yalnızca bir kez kullanır. Korunan işlemi yapmadan hemen önce çağırın; tekrar gönderilen bir token ya da yeniden denenen form 409 already_used alır. SDK guard'ları (requireTouchque, relay router'lar, tq.complete) bunu sizin için çağırır.

POST/login/{id}/consume
DurumAnlam
200Kullanıldı: kullanıcı, tip, detaylar, assurance, approvalProof
409already_used · rejected · expired · not_approved
404Sizin isteğiniz değil
İstek
const { Touchque } = require('@touchque/node');

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

// Onayı yalnız bir kez kullanın: ikinci çağrı 'already_used' (409) hatası verir.
// login.consume @touchque/node 5.2.0'da var; tq.complete(requestId, { user, action })
// tek çağrıda hem kullanır hem kontrol eder.
const approval = await tq.login.consume('request_id_here');
if (approval.externalUsername !== user || approval.type !== 'LOGIN') {
  throw new Error('This approval is for another user or action');
}
Cevap 200
{
  "consumed": true,
  "requestId": "…",
  "externalUsername": "user@yourcompany.com",
  "type": "WITHDRAW",
  "confirmedVia": "DEVICE",
  "assurance": { "phishingResistant": false, "method": "push" },
  "approvalProof": { "version": "v2", "…": "…" }
}