Geliştirici Dokümantasyonu

VerifyBlind'yi kendi platformunuza dakikalar içinde entegre edin.

Başlarken (Quickstart)

VerifyBlind entegrasyonu üç adımdan oluşur: hesap açma, backend nonce endpoint yazma ve widget embed etme. Server-side webhook opsiyoneldir — yalnızca frontend widget ile de tam çalışır.

Partner Hesabı & API Key

Partner Portal'a kayıt olun ve Settings sayfasından API Key'inizi kopyalayın. API Key bir UUID'dir. Asla frontend'e gömmeyin.

Backend Nonce Endpoint

Widget, tarayıcıda oluşturduğu geçici RSA public key'i backend'inizdeki bir endpoint'e gönderir. Bu endpoint aldığı veriyi VerifyBlind API'ye iletip nonce döndürür. API key sunucu tarafında kalır.

// POST /generate-nonce  (Express)
app.post('/generate-nonce', async (req, res) => {
  const { public_key, validations, additional_data, sdk_version } = req.body;
  const response = await fetch('https://api.verifyblind.com/api/pop/generate', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'X-API-Key': process.env.VERIFYBLIND_API_KEY },
    body: JSON.stringify({ public_key, validations, additional_data, sdk_version }),
  });
  res.json(await response.json()); // { "nonce": "b1362715-..." }
});

Widget Embed

Sayfanıza verifyblind.js'yi ekleyin.

HTML

<script src="https://cdn.verifyblind.com/sdk/v1.0.0/verifyblind.js"
        integrity="sha384-TRoHlSq3GSFXepiilMFxyyVsHt23aFYuk03hDTFZGMCYSU6qQckiEFjVk8Nssixe"
        crossorigin="anonymous"></script>
<div id="verifyblind-container"></div>
<script>
window.VerifyBlind.init({
  generateUrl:  '/generate-nonce',
  apiUrl:       'https://api.verifyblind.com',
  captcha:      true,
  payload: {
    validations:  { age: '18+', user_id: true },
    additional_data: { session_id: 'abc123' },
  },
  containerId: 'verifyblind-container',
  onSuccess: (data) => {
    console.log(data.validations.age);      // true / false
    // user_id istendiğinde 3 kod birden döner — üçünü de saklayın:
    console.log(data.validations.user_id);  // "a1b2c3..." (TCKN bazlı, TCKN yoksa boş)
    console.log(data.validations.nsbd_id);  // biyografik kişi kovası (kart yenilemede sabit)
    console.log(data.validations.doc_id);   // "I_9f8e..." belge kodu (aynı belge = aynı kişi)
  },
  onError: (err) => console.error(err),
});
</script>

Akış Özeti

Tarayıcı (verifyblind.js)         Partner Backend        VerifyBlind API
──────────────────────────────────────────────────────────────────
1. Geçici RSA key çifti oluştur
2. public_key + validations ──► POST /generate-nonce ──► POST /api/pop/generate
                            ◄── { nonce }            ◄──  { nonce }
3. QR göster (nonce embed)
4. Kullanıcı QR'ı okutup telefonda doğruladı
5. GET /api/pop/result/{nonce} (polling) ─────────────────────────►
6. { status: "completed", encrypted_response: {...} } ◄───────────
7. Tarayıcıda geçici private key ile deşifrele
8. onSuccess(data) ✓