API سازمانی WhoDNS
همان ابزارهای سایت، به شکل REST. احراز هویت با هدرِ Authorization: Bearer یا X-API-Key؛ پاسخ‌ها JSON با ساختار استاندارد {ok, data|error}.
شروع سریع
curl "https://whodns.ir/api/v1/dns?domain=example.com" -H "Authorization: Bearer YOUR_KEY"کلید رایگان بسازید: کلیدهای API · تعرفه: تعرفهٔ API
Playground تعاملی
کلید شما فقط در مرورگرِ خودتان (localStorage) نگه داشته می‌شود و مستقیم به /api/v1 ارسال می‌شود.
/api/v1/me
خلاصهٔ کلید و مصرف
نام، وضعیت، بخش‌های مجاز، سقف‌ها، مصرفِ فعلی و تاریخِ انقضای همان کلیدی که با آن درخواست می‌دهید. همیشه در دسترس است و از سهمیه کم نمی‌کند؛ برای آزمایشِ کلید و پایشِ مصرف مناسب است.
/api/v1/dns
بررسیِ DNS (A و NS)
رکوردهای A (IPv4) و NS (نیم‌سرور) یک دامنه از دیدِ resolverِ انتخابی. پاسخِ سبک و سریع؛ سایر بخش‌های سنگینِ بررسیِ DNS (دسترس‌پذیری، DNSSEC، امنیتِ ایمیل و امتیاز) عمداً در این endpoint گنجانده نشده‌اند.
| پارامتر | الزامی | شرح | نمونه |
|---|---|---|---|
domain | ✓ | دامنه، مثل example.com | example.com |
resolver | — | resolverِ DNS: 8.8.8.8 (پیش‌فرض)، 1.1.1.1، 9.9.9.9، 178.22.122.100 (شکن)، 78.157.42.100 (الکترو)، system یا هر IPِ عمومیِ دیگر. | 1.1.1.1 |
/api/v1/dnssec
بررسیِ DNSSEC
وضعیتِ DNSSECِ یک دامنه از دیدِ یک resolverِ اعتبارسنجِ عمومی: رکوردهای DS نزدِ دامنهٔ والد، کلیدهای DNSKEY (KSK و ZSK) و پرچمِ AD.
| پارامتر | الزامی | شرح | نمونه |
|---|---|---|---|
domain | ✓ | دامنه، مثل example.com | cloudflare.com |
/api/v1/ptr
جست‌وجوی PTR (DNSِ معکوس)
نامِ معکوسِ (PTR) یک IPv4، زونِ معکوس و نیم‌سرورهایش، سرورِ اصلیِ زون (SOA) و نیم‌سروری که واقعاً پاسخ داد؛ به‌همراهِ مالک و ISPِ IP.
| پارامتر | الزامی | شرح | نمونه |
|---|---|---|---|
ip | ✓ | آدرسِ IPv4، مثل 8.8.8.8 | 8.8.8.8 |
resolver | — | resolverِ DNS: 8.8.8.8 (پیش‌فرض)، 1.1.1.1، 9.9.9.9، 178.22.122.100 (شکن)، 78.157.42.100 (الکترو)، system یا هر IPِ عمومیِ دیگر. | 1.1.1.1 |
/api/v1/myip
آی‌پیِ من و اطلاعاتِ IP
بدونِ پارامتر، IPی را برمی‌گرداند که درخواستِ شما از آن رسیده (IPِ خروجیِ سرورِ شما) با کشور، شهر، ASN و ISP. با پارامترِ ip، اطلاعاتِ همان IP برگردانده می‌شود.
| پارامتر | الزامی | شرح | نمونه |
|---|---|---|---|
ip | — | یک IP برای استعلام؛ خالی یعنی IPِ خودتان. | 8.8.8.8 |
/api/v1/cdn
تشخیصِ CDN و WAF
تشخیصِ شبکهٔ توزیعِ محتوا (CDN)، فایروالِ وب (WAF) و سرورِ جلوییِ یک سایت از روی زنجیرهٔ CNAME، نیم‌سرورها، هدرها، کوکی‌ها و مالکِ IP؛ هر مورد همراهِ شاهد (evidence).
| پارامتر | الزامی | شرح | نمونه |
|---|---|---|---|
host | ✓ | دامنه یا IP، مثل example.com | example.com |
/api/v1/ssl
بررسیِ گواهیِ SSL
گواهیِ TLSِ یک دامنه: صادرکننده، تاریخِ اعتبار و روزهای باقی‌مانده، نام‌های پوشش‌داده‌شده (SAN)، زنجیره، معتبر بودنِ زنجیره و تطبیقِ نام.
| پارامتر | الزامی | شرح | نمونه |
|---|---|---|---|
domain | ✓ | دامنه، مثل example.com | example.com |
port | — | پورتِ TLS؛ پیش‌فرض 443. | 443 |
/api/v1/tls
اسکنِ نسخه و رمزِ TLS
نسخه‌های TLSِ پشتیبانی‌شده (1.0 تا 1.3)، رمزِ مذاکره‌شده برای هر نسخه و نسخه‌های ناامنِ فعال.
| پارامتر | الزامی | شرح | نمونه |
|---|---|---|---|
host | ✓ | دامنه یا IP، مثل example.com | example.com |
port | — | پورتِ TLS؛ پیش‌فرض 443. | 443 |