فحص النطاق

تفحص اسم نطاق من حيث العمر وسجلات توثيق البريد والخطورة المعروفة.

نظرة عامة#

يستقبل lookup/domain المعامل domain مثل example.com ويُرجع name وهل النطاق مصنَّف خطِرًا (is_dangerous) وتاريخ إنشائه (created_at) وهل هو حديث (is_new) ووجود سجلات DNS التي تجعل البريد موثوقًا: is_mx وis_spf وis_dkim وis_dmarc وis_bimi.

كتلة النطاق نفسها مضمَّنة في استجابة تقييم البريد الإلكتروني؛ استخدم هذه الدالة حين تريد تقييم موقع أو نطاق بمفرده.

متى تستخدمه#

• لفحص موقع يعطيك إياه تاجر أو شريك أثناء التسجيل.
• لفرز نطاق رابط يرسله المستخدمون.
• لفحص نطاق شركة قبل الوثوق بتسجيل "تجاري".

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

• is_new: true تعني أن النطاق سُجّل حديثًا. حملات الاحتيال تعتمد على نطاقات مؤقتة، فالتسجيل الحديث يستحق تدقيقًا إضافيًا.
• is_dangerous: true أقوى إشارة؛ ارفض أو راجِع يدويًا.
• is_mx تبيّن هل يستطيع النطاق استقبال البريد أصلًا. وبدونها يقل احتمال أن يكون عنوان على هذا النطاق حقيقيًا.
• is_spf وis_dkim وis_dmarc تبيّن هل ضبط المالك توثيق المُرسِل. نطاق الأعمال الشرعي يملكها عادة، أما النطاق الحديث أو المسيء فغالبًا لا. وis_bimi تدل على مُرسِل موثَّق العلامة وهي إشارة إيجابية خفيفة.
• لا يُعد أي مؤشر دليلًا بمفرده؛ انظر إليها مجتمعة مع created_at.

ملاحظات#

• تُحتسب طلبًا واحدًا. وضع الاختبار يُرجع بيانات وهمية مجانًا ولا يستعلم DNS.
• مشمولة في كل الباقات بما فيها القياسية.
• لا تطلق أحداثًا. وتُقيَّم بيانات النطاق في القواعد المخصصة عبر مجموعة البريد فقط، من خلال الحقل domain.name.
• النطاق المفقود أو غير الصحيح يُرجع الخطأ 128 (invalid_domain) مع HTTP 200.

الطلب#

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

المعاملات#

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

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

curl -G "https://gurdx.cretip.com/api/lookup/domain" \
  --data-urlencode "key=YOUR_API_KEY" \
  --data-urlencode "domain=example.com"

<?php

$response = file_get_contents('https://gurdx.cretip.com/api/lookup/domain?'.http_build_query(['key' => 'YOUR_API_KEY', 'domain' => '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","domain":"example.com"});
const res = await fetch(`https://gurdx.cretip.com/api/lookup/domain?${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/lookup/domain", params={"key": "YOUR_API_KEY", "domain": "example.com"})
result = res.json()

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

الاستجابة#

نجاح#

{
    "data": {
        "name": "dangerous-domain.com",
        "is_dangerous": true,
        "is_disposable": false,
        "is_forwarding": false,
        "is_spf": false,
        "is_dmarc": false,
        "is_dkim": false,
        "is_mx": false,
        "is_bimi": false,
        "created_at": "2025-02-05",
        "is_new": true
    },
    "status": "success",
    "executionTime": 0
}

خطأ#

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

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

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