דילוג לתוכן

Trust Center

אימות המשתמשים שלכם: מסמכי זהות, השוואת פנים ובדיקות חברה.

פתיחת Trust Center
נבדק מול לוח הבקרה ב-18 בנובמבר 2026

שלוש שיטות עושות מהקוד את מה שהחלון אימות אדם עושה: פותחות סשן, קוראות סשן ומפרטות סשנים. כל אחת פועלת על ה-Trust Center של החשבון שמפתח ה-API שלכם שייך לו.

פותחים סשן

קוראים ל-verify_session_create. שולחים level (1 עד 4, ברירת מחדל 2) ואם רוצים, external_ref משלכם (עד 200 תווים). התשובה נושאת session_id, hosted_url לשלוח לאדם, ו-expires_at, שהוא 24 שעות קדימה.

מפנים את המשתמש שלכם אל hosted_url, או שולחים לו אותו.

קוראים את התוצאה

קוראים ל-verify_session_result עם ה-session_id. היא מחזירה את ה-status, את ה-external_ref שלכם, את הזמנים ואת ה-result ברגע שהסשן הושלם.

curl -s https://xuda.ai/cpi/verify_session_create \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","level":2,"external_ref":"user_482"}'
const res = await fetch('https://xuda.ai/cpi/verify_session_create', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_API_KEY', level: 2, external_ref: 'user_482' }),
});
const { code, data } = await res.json();
// data.hosted_url is where you send this user next.
import requests

res = requests.post(
    'https://xuda.ai/cpi/verify_session_create',
    json={'api_key': 'YOUR_API_KEY', 'level': 2, 'external_ref': 'user_482'},
)

מה קובע את הסשן

  • המצב. סשן הוא בדיקה כשהשירות פועל במצב בדיקה, ולייב כשהוא פועל בלייב. סשנים של בדיקה הם חינם ואף פעם לא נספרים, ואפשר לסיים אותם מהדשבורד. עדיין אי אפשר להשלים קישורי לייב.
  • הרמה. רמה מעל מה שהתוכנית שלכם מאפשרת נדחית, עם ציון איזו תוכנית נושאת אותה. הבקשה אף פעם לא מורדת בשקט.
  • מעבר למכסה. סשן לייב מעבר למכסה החודשית של התוכנית נדחה ב-Free, ובתוכנית בתשלום הוא נוצר ומסומן כחריגה.

מפתחות נוצרים ב-Developers, ויצירת מפתח דורשת רמה 2 משלכם.

דחיות

Webhooks

מ-Starter ומעלה, קובעים כתובת בהגדרות Trust Center ובקשה חתומה נשלחת כשאימות מוכרע, כך שאין צורך לבצע polling. כל אחת נושאת כותרת Xuda-Event וכותרת Xuda-Signature שמורכבת מחותמת זמן ומ-HMAC של חותמת הזמן והגוף, חתום בסוד שמוצג פעם אחת בהגדרות. משלוח שנכשל מנוסה שוב, עד חמישה ניסיונות.

איך המדריך הזה?

עודכן לאחרונה ב-16 בנובמבר 2026