تقييم البريد الإلكتروني

تقيّم عنوان بريد إلكتروني بدرجة من 0 إلى 3 تعبّر عن احتمال كونه وهميًا أو مؤقتًا أو مسيئًا.

نظرة عامة#

تقيّم scoring/email العنوان الممرَّر في email دون إرسال أي شيء إليه. وتُرجع score وreason بلغة مفهومة والقيم المنطقية isValid وisDisposable وisFree وisRoleBased وisEducational ومؤشر blacklisted وكتلة domain بعمر النطاق وحالة MX وSPF وDKIM وDMARC وBIMI (وهي بيانات فحص النطاق نفسها).

متى تستخدمه#

• لمنع العناوين المؤقتة عند التسجيل وإنشاء التجارب واستخدام العروض.
• لتقرير ما إذا كنت ستطلب تأكيد البريد أو تحققًا إضافيًا.
• لتنظيف قائمة بريدية قبل الحملة حفاظًا على سمعة مرسلك.

قراءة النتيجة#

تتدرج score من 0 (سليم) إلى 3 (سيئ على الأرجح). سياسة معقولة:

• من 0 إلى 1: اقبل بشكل طبيعي.
• 2: اقبل مع التحقق، مثل إرسال رابط تأكيد وتقييد صلاحيات الحساب إلى أن يُضغط.
• 3: ارفض أو أحِل إلى مراجعة يدوية.

اقرأ المؤشرات لفهم السبب. isDisposable أقوى مؤشر على الإساءة. وisFree (مزودو البريد المجاني) طبيعي للمستهلكين ولا يعني الكثير وحده، بينما isRoleBased (مثل info@ وsupport@) تعني صندوقًا مشتركًا لا شخصًا. وisEducational تدل على نطاقات المدارس والجامعات، وهذا مفيد إن كان لديك سعر للطلاب. والنطاق الحديث أو بلا سجل MX يرفع الدرجة.

إشارات إضافية#

• suggestion: عندما يبدو النطاق خطأً إملائيًا لمزوّد كبير (gmial.com وhotmial.com وyaho.com وoutlok.com وicloud.co وgmail.con) يُرجع العنوان المصحَّح مثل ahmed@gmail.com، وإلا null. اعرضه بصيغة «هل تقصد...؟». والنطاق الخاطئ بلا MX يأخذ الدرجة 3 (Email domain looks like a typo of gmail.com.)، وإن كان يستقبل البريد فالدرجة 2 على الأقل.
• isGibberish: تكون true عندما يبدو الجزء قبل @ مولَّدًا عشوائيًا أو ضربًا على لوحة المفاتيح (xk3j9qz2v وqwerty123 وaaaaaa1 أو سلسلة أرقام طويلة). والفحص متحفظ ولا يُعلِّم الأسماء العادية العربية أو اللاتينية مثل mohammed.alqahtani أو noura1995. ويرفع الدرجة إلى 1 على الأقل.
• normalized: العنوان القياسي لاكتشاف تعدد الحسابات. يُحوَّل إلى أحرف صغيرة وتُحذف لاحقة +tag وتُزال نقاط عناوين Gmail، فيصير A.B+shop@gmail.com هو ab@gmail.com. ويبقى الأصل في email.

ملاحظات#

• تُحتسب طلبًا واحدًا. وضع الاختبار يُرجع بيانات وهمية مجانًا دون أحداث.
• ليست ضمن الباقة القياسية؛ متاحة في التجربة والمميّزة والدفع حسب الاستخدام. وبدون صلاحية يصلك الخطأ 117 (feature_not_available).
• يمكن لـالقواعد المخصصة في مجموعة البريد اختبار العنوان والنطاق وكل مؤشر، واستبدال الدرجة، أو تعليم العنوان كصالح أو غير صالح. وتُسرد التطابقات في custom_rules_applied.
• يُطلَق حدث spam_email عندما تكون الدرجة 2 أو أعلى ويُرسل إلى الويب هوك.
• العنوان المفقود أو غير الصحيح يُرجع الخطأ 119 (invalid_email_address) مع HTTP 200.

الطلب#

• صادِق بمعامل key أو بترويسة Authorization: Bearer.
• تُحتسب طلباً واحداً.
• متاحة في: تجربة مجانية المميّزة الدفع حسب الاستخدام

المعاملات#

تقبل كل خدمة أيضاً format, lang, mode, userID, callback. راجع الخيارات.

أمثلة برمجية#

curl -G "https://gurdx.cretip.com/api/scoring/email" \
  --data-urlencode "key=YOUR_API_KEY" \
  --data-urlencode "email=user@example.com"

<?php

$response = file_get_contents('https://gurdx.cretip.com/api/scoring/email?'.http_build_query(['key' => 'YOUR_API_KEY', 'email' => 'user@example.com']));
$result = json_decode($response, true);

if ($result['status'] === 'success') {
    print_r($result['data']);
} else {
    echo $result['code'].': '.$result['description'];
}

const params = new URLSearchParams({"key":"YOUR_API_KEY","email":"user@example.com"});
const res = await fetch(`https://gurdx.cretip.com/api/scoring/email?${params}`);
const result = await res.json();

if (result.status === 'success') {
  console.log(result.data);
} else {
  console.error(result.code, result.description);
}

import requests

res = requests.get("https://gurdx.cretip.com/api/scoring/email", params={"key": "YOUR_API_KEY", "email": "user@example.com"})
result = res.json()

if result["status"] == "success":
    print(result["data"])
else:
    print(result["code"], result["description"])

الاستجابة#

نجاح#

{
    "data": {
        "score": 3,
        "reason": "Email domain is considered dangerous.",
        "isValid": false,
        "isFree": false,
        "isRoleBased": true,
        "isEducational": false,
        "isDisposable": false,
        "blacklisted": false,
        "email": "test@dangerous-domain.com",
        "domain": {
            "name": "dangerous-domain.com",
            "is_dangerous": true,
            "is_spf": false,
            "is_dmarc": false,
            "is_dkim": false,
            "is_mx": false,
            "is_bimi": false,
            "created_at": "2025-02-05",
            "is_new": true
        },
        "custom_rules_applied": {
            "total": 0,
            "rules": []
        },
        "suggestion": null,
        "isGibberish": false,
        "normalized": "test@dangerous-domain.com"
    },
    "status": "success",
    "executionTime": 1
}

خطأ#

تُسلَّم الأخطاء بحالة HTTP 200 — افحص دائماً حقل status.

{
    "status": "error",
    "code": 101,
    "type": "invalid_key",
    "description": "The API Key is missing or invalid."
}

حقول الاستجابة#