API للمتاجر والشركات

الطلب

POST /api/v1/check مع المفتاح في ترويسة Authorization: Bearer.

• target: رابط، أو نطاق، أو آيبان، أو رقم جوال، أو إيميل، أو حساب سوشيال (لين 2048 حرف).
• text: بدال target، نص رسالة كاملة نقارنه بأساليب النصب ونفحص روابطه (لين 2000 حرف).
• lang: ‏ar أو en للغة الأسباب (اختياري).

curl -X POST https://allsitey.com/api/v1/check \
  -H "Authorization: Bearer alls_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target": "example-store.com", "lang": "ar"}'

الرد

الحكم واحد من: fraud (احتيال)، suspicious (مشكوك)، trusted (ما لقينا علامات خطر)، neutral، unknown. ومع كل فحص السبب. الآيبان والرقم والإيميل والحساب ما يطلع لها trusted أبداً، لأننا ما نقدر نتأكد من صاحبها.

{
  "target": "example-store.com",
  "verdict": {
    "verdict": "suspicious",
    "risk": 55,
    "trust": 45,
    "reasons": ["…"]
  },
  "results": [ { "investigator": "domain_age", "verdict": "suspicious", "risk": 50, "reason": "…" } ],
  "remaining": 487
}

الأخطاء والحدود

• 401 invalid_key
• 400 bad_request
• 413 too_large
• 422 invalid target
• 429 quota · daily limit per key (resets at midnight, Riyadh time)

الفحص يستغرق عادةً من ثانيتين إلى 15 ثانية حسب الموقع. خلّ مهلة الطلب عندك 60 ثانية على الأقل. وما نحفظ الروابط ولا النصوص اللي ترسلها، نحسب عدد الفحوصات لكل مفتاح بس.