فحص الشبكة ASN

تُرجع بيانات السجل لنظام مستقل: مالكه وبيانات الاتصال به ونوعه ونطاقات IP التي يعلنها.

نظرة عامة#

رقم النظام المستقل (ASN) يعرّف شبكة تُوجّه حركة الإنترنت، كمزود خدمة أو مزود سحابة أو شركة. يستقبل lookup/asn المعامل asn، بصيغة AS6167 أو 6167 فقط، ويُرجع من يدير هذه الشبكة: name وorg وcountry وdomain وبريد الاتصال email والهاتف phone وregistry وtype وتاريخ الإنشاء والحالة، إضافة إلى ملخص prefixes بعدد نطاقات IPv4 وIPv6 التي تعلنها.

متى تستخدمه#

• للتحقيق في نتيجة IP: خذ asn.asn من استجابة فحص عنوان IP واعرف مالكها.
• لبناء منطق سماح أو رفض حول شبكات محددة، مثل مزودي الاستضافة المعروفين.
• لإثراء بلاغات الإساءة وحالات الدعم بالجهة المسؤولة.

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

• type يبيّن نوع الشبكة. شبكات الاستضافة والأعمال خلف حركة المستهلكين علامة كلاسيكية على البروكسيات والروبوتات، بينما شبكات مزودي الإنترنت تعني غالبًا مستخدمين عاديين.
• prefixes.total وprefixes.ipv4 وprefixes.ipv6 تعطي فكرة عن الحجم. والشبكة الصغيرة جدًا قد تكون بنية مخصصة.
• domain وemail وphone هي بيانات الاتصال المنشورة في السجل، وهي مفيدة عند الإبلاغ عن إساءة.
• status وcreated يبيّنان هل التسجيل ساري وكم عمره.

يأتي email وphone من سجل تسجيل الشبكة: جهة الإساءة أولًا ثم الجهات الفنية والتشغيلية والإدارية. تُجلب عند أول طلب وتُحفظ 30 يومًا، ولا يُفشل تعطّلُ السجل الاستدعاء؛ عندها تكون الحقول null أو تحمل آخر قيمة لدينا. كما يأتي created وstatus من سجل التسجيل.

بيانات السجل عامة وقد تكون ناقصة أحيانًا، فالحقول الفارغة أمر طبيعي.

ملاحظات#

• تُحتسب طلبًا واحدًا. وضع الاختبار يُرجع بيانات وهمية مجانًا ولا يتصل بأي خدمة خارجية.
• هذه الدالة ليست ضمن الباقة القياسية؛ فهي متاحة في التجربة والمميّزة والدفع حسب الاستخدام. استدعاؤها دون صلاحية يُرجع الخطأ 117 (feature_not_available).
• لا تطلق أحداثًا ولا ترتبط بقواعد مخصصة أو قوائم سوداء.
• القيمة الفارغة أو غير الصحيحة تُرجع الخطأ 121 (invalid_asn) مع HTTP 200.

الطلب#

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

المعاملات#

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

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

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

<?php

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

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

الاستجابة#

نجاح#

{
    "data": {
        "asn": "AS9112",
        "name": "POZMAN",
        "country": "PL",
        "org": "Institute of Bioorganic Chemistry Polish Academy of Science, Poznan Supercomputing and Networking Center",
        "phone": "+48 61 8582010",
        "email": null,
        "domain": "poznan.pl",
        "status": "ASSIGNED",
        "created": "2004-04-17T11:47:57Z",
        "type": "education",
        "registry": "RIPE",
        "prefixes": {
            "ipv4": [
                "150.254.0.0/16",
                "62.3.160.0/19"
            ],
            "ipv6": [
                "2001:808::/35"
            ],
            "total": 3
        }
    },
    "status": "success",
    "executionTime": 0
}

خطأ#

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

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

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