DNSSOR REST API
الإصدار 1.0 — عنوان URL الأساسي: https://dnssor.com/api/v1
واجهة برمجة تطبيقات JSON سريعة وموثوقة لعمليات بحث DNS واستعلامات WHOIS وتحليل شهادة SSL وتحديد الموقع الجغرافي IP. مصممة للمطورين ومسؤولي النظام.
🔐 🔐 التوثيق
تتطلب جميع الطلبات مفتاح API. قم بالمصادقة عبر Google للحصول على واحدة على الفور - دون الحاجة إلى نموذج تسجيل.
الخيار 1 – الرأس (مستحسن)
X-API-Key: demo-key-dnssor-2026
الخيار 2 - سلسلة الاستعلام
?api_key=demo-key-dnssor-2026
🧪 المفتاح التجريبي للاختبار:
demo-key-dnssor-2026 (حد 100 طلب/ساعة) ⚡ ⚡ حدود المعدل
| Plan | الطلبات/ساعة | ذاكرة التخزين المؤقت TTL |
|---|---|---|
| العرض التوضيحي (بدون مصادقة) | — | — |
| مجاني (تسجيل الدخول إلى جوجل) | 100 | غير متاح |
| برو (اتصل بنا) | 10,000 | غير متاح |
يؤدي تجاوز الحدود إلى إرجاع HTTP 429. الرؤوس: X-RateLimit-Remaining
📡 📡 نقاط النهاية
| طريقة | نقطة النهاية | وصف | مخبأ |
|---|---|---|---|
| GET | /api/v1/dns | بحث DNS (A، AAAA، MX، NS، TXT، CNAME، SOA) | 5 min |
| GET | /api/v1/whois | تحليل WHOIS + البيانات الأولية | 1 hr |
| GET | /api/v1/ssl | تفاصيل شهادة SSL + SAN + الأيام المتبقية | 1 hr |
| GET | /api/v1/ip | تحديد الموقع الجغرافي IP + ISP + ASN + DNS العكسي | 1 hr |
| GET | /api/v1/ping | اختبار ping لـ TCP (4 حزم عبر المنفذ 80) | غير متاح |
| GET | /api/v1/status | الحالة التشغيلية لواجهة برمجة التطبيقات (API). | غير متاح |
GET /api/v1/dns
الاستعلام عن سجلات DNS للمجال.
| المعلمة | يكتب | مطلوب | وصف |
|---|---|---|---|
| domain | string | ✅ | Domain |
| type | string | — | نوع التسجيل: A، AAAA، MX، NS، TXT، CNAME، SOA، ALL (الافتراضي: ALL) |
| server | string | — | عنوان IP لخادم DNS (الافتراضي: 1.1.1.1) |
curl "https://dnssor.com/api/v1/dns?domain=google.com&type=MX" \
-H "X-API-Key: demo-key-dnssor-2026"
إجابة:
{
"success": true,
"data": {
"domain": "google.com",
"server": "1.1.1.1",
"records": [
{ "type": "MX", "name": "google.com", "value": "smtp.google.com", "ttl": 3600, "extras": { "pref": 10 } }
],
"count": 1
},
"timestamp": 1784497022}
GET /api/v1/whois
| المعلمة | مطلوب | وصف |
|---|---|---|
| domain | ✅ | Domain |
| raw | — | WHOIS الخام |
curl "https://dnssor.com/api/v1/whois?domain=google.com&raw=1" \
-H "X-API-Key: demo-key-dnssor-2026"
GET /api/v1/ssl
curl "https://dnssor.com/api/v1/ssl?domain=google.com" \
-H "X-API-Key: demo-key-dnssor-2026"
GET /api/v1/ip
| المعلمة | مطلوب | وصف |
|---|---|---|
| ip | ✅ | عنوان IP |
curl "https://dnssor.com/api/v1/ip?ip=8.8.8.8" \
-H "X-API-Key: demo-key-dnssor-2026"
📦 📦 المكتبات وحزم SDK
JavaScript / Node.js
const res = await fetch(
'https://dnssor.com/api/v1/dns?domain=google.com',
{ headers: { 'X-API-Key': 'demo-key-dnssor-2026' } }
);
const data = await res.json();
Python
import requests
r = requests.get(
'https://dnssor.com/api/v1/dns',
params={'domain': 'google.com'},
headers={'X-API-Key': 'demo-key-dnssor-2026'}
)
هل أنت مستعد لبدء الاندماج؟
قم بتسجيل الدخول بشكل آمن باستخدام حساب Google الخاص بك لتلقي مفتاح API الشخصي المجاني الخاص بك على الفور.
قم بتسجيل الدخول باستخدام جوجللا توجد بطاقة ائتمان. لا يوجد استمارة التسجيل. 100 طلب/ساعة متضمنة.