DNSSOR REST API
نسخه 1.0 - URL پایه: https://dnssor.com/api/v1
یک API 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 | تست پینگ 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": 1788736644}
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 درخواست در ساعت گنجانده شده است.