Webhook Uyarıları API

Uç Noktalar

Her uyarıyı doğrulayın

Ham istek gövdesini alındığı haliyle kullanın. Başlık bir imza, sır rotasyonu sırasında ise iki imza içerir. İmzalardan biri eşleştiğinde isteği kabul edin.

import crypto from 'node:crypto';

// rawBody: the request body exactly as received, before JSON parsing.
function verifyDomScanWebhook(rawBody, headers, secret) {
  const timestamp = headers['x-domscan-timestamp'];
  const header = headers['x-domscan-signature'] || '';
  if (!/^\d{10}$/.test(timestamp || '')) return false;
  if (Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return false;
  const expected = Buffer.from('sha256=' + crypto
    .createHmac('sha256', secret)
    .update(timestamp + '.' + rawBody)
    .digest('hex'));
  // One entry normally; two during a secret rotation (new secret first).
  return header.split(',').some((entry) => {
    const candidate = Buffer.from(entry.trim());
    return candidate.length === expected.length &&
      crypto.timingSafeEqual(candidate, expected);
  });
}

Sırları 24 saatlik geçiş süresiyle yenileyin

Rotasyon yeni sırrı bir kez döndürür. Geçiş süresi bitene kadar her uyarı önce yeni sırla, ardından önceki sırla imzalanır; böylece hâlâ eski sırrı kullanan alıcılar çalışmaya devam eder.

X-DomScan-Signature: sha256=<new>,sha256=<previous>

HTTP durum kodları

İstemcinizin işlemesi gereken HTTP durum kodları şunlardır; böylece başarılı yanıtları, kimlik doğrulama sorunlarını, kredileri, hız sınırlarını, eksik verileri ve üst kaynak hatalarını birbirinden ayırabilirsiniz.