رفتن به محتوا
ipaddress.tr

API

همان داده‌های وب‌سایت، به‌صورت JSON یا متن ساده. بدون کلید و حساب؛ محدودیت‌های منصفانه اعمال می‌شود.

curl https://ipaddress.tr/api/v1/my-ip?format=text

نقاط پایانی

مسیرتوضیحدادهمحدودیت نرخ
GET/api/v1/my-ipامتحان: /api/v1/my-ipنشانی IP شما (همچنین به‌صورت متن ساده با ?format=text).مجموعه‌دادهٔ خودمان120 · 240/دقیقه
GET/api/v1/ip/{address}امتحان: /api/v1/ip/144.122.145.153داده‌های شبکه، مسیریابی، ثبت و موقعیت برای یک نشانی.مجموعه‌دادهٔ خودمان30 · 30/دقیقه
GET/api/v1/ip/geolocation?ip=امتحان: /api/v1/ip/geolocation?ip=177.224.0.1فقط تخمین موقعیت یک نشانی (DB-IP Lite) که همیشه تخمینی علامت‌گذاری می‌شود.مجموعه‌دادهٔ خودمان30 · 30/دقیقه
GET/api/v1/ip/asn?ip=امتحان: /api/v1/ip/asn?ip=2001:1208::1AS مبدأ و پیشوند اعلام‌شدهٔ یک نشانی و واگذاری ثبتی که در آن قرار دارد.مجموعه‌دادهٔ خودمان30 · 30/دقیقه
GET/api/v1/ip/reverse?ip=امتحان: /api/v1/ip/reverse?ip=8.8.8.8رکورد PTR یک نشانی عمومی، زنده، با تأیید مستقیم.پرس‌وجوی زنده40 · 60/دقیقه
GET/api/v1/ip/blacklist?ip=امتحان: /api/v1/ip/blacklist?ip=8.8.8.8نتایج زندهٔ DNSBL (SpamCop، PSBL، DroneBL، s5h.net) و نشانگر خروجی Tor برای یک نشانی عمومی.پرس‌وجوی زنده40 · 60/دقیقه
POST/api/v1/bulkcurl --data-binary $'1.1.1.1\n9.9.9.9' https://ipaddress.tr/api/v1/bulkتا ۱۰۰ نشانی یک‌جا (JSON {"addresses": […]} یا هر خط یک نشانی) که فقط از مجموعه‌داده‌های خودمان پاسخ داده می‌شود. چیزی ذخیره نمی‌شود.مجموعه‌دادهٔ خودمان6 · 3/دقیقه
GET/api/v1/asn/{asn}امتحان: /api/v1/asn/AS8151دارنده، ثبت‌کننده و پیشوندهای اعلام‌شدهٔ یک سیستم خودمختار.مجموعه‌دادهٔ خودمان30 · 30/دقیقه
GET/api/v1/network/{cidr}امتحان: /api/v1/network/144.122.0.0/16یک شبکه با نمادگذاری CIDR: اندازه، بازه، وضعیت کاربرد ویژه، اعلام‌کننده (با RPKI)، واگذاری ثبت و تخمین موقعیت.مجموعه‌دادهٔ خودمان30 · 30/دقیقه
GET/api/v1/network/ipv4?cidr=امتحان: /api/v1/network/ipv4?cidr=192.168.1.37/24محاسبهٔ زیرشبکه برای یک شبکهٔ IPv4 یا IPv6: شبکه، نشانی همگانی، ماسک‌ها، بازهٔ قابل استفاده و شمارش‌ها.مجموعه‌دادهٔ خودمان120 · 240/دقیقه
GET/api/v1/network/ipv6?cidr=امتحان: /api/v1/network/ipv6?cidr=2001:db8::/48محاسبهٔ زیرشبکه برای یک شبکهٔ IPv4 یا IPv6: شبکه، نشانی همگانی، ماسک‌ها، بازهٔ قابل استفاده و شمارش‌ها.مجموعه‌دادهٔ خودمان120 · 240/دقیقه
GET/api/v1/country/{cc}امتحان: /api/v1/country/MXفضای نشانی و شماره‌های AS ثبت‌شدهٔ یک کشور، آنچه شبکه‌هایش اعلام می‌کنند، پوشش RPKI و بزرگ‌ترین شبکه‌ها (برای TR همچنین تخمین بر اساس استان).مجموعه‌دادهٔ خودمان30 · 30/دقیقه
GET/api/v1/dns/{domain}?type=A,MXامتحان: /api/v1/dns/metu.edu.tr?type=A,MXرکوردهای زندهٔ DNS یک دامنه.پرس‌وجوی زنده40 · 60/دقیقه
GET/api/v1/dns/propagation?name=&type=امتحان: /api/v1/dns/propagation?name=metu.edu.tr&type=Aهمان پرسش DNS از چند حل‌کنندهٔ عمومی، با هر پاسخ و اینکه آیا هم‌نظرند.پرس‌وجوی زنده40 · 60/دقیقه
GET/api/v1/rdap/{query}امتحان: /api/v1/rdap/AS8151دادهٔ ثبت از سرور معتبر RDAP.پرس‌وجوی زنده10 · 6/دقیقه
GET/api/v1/healthامتحان: /api/v1/healthسلامت سرویس.مجموعه‌دادهٔ خودمان120 · 240/دقیقه
GET/api/v1/data-statusامتحان: /api/v1/data-statusسن و اندازهٔ هر مجموعه‌داده.مجموعه‌دادهٔ خودمان120 · 240/دقیقه

میان‌برهای متن ساده بیرون از /api/v1: ‏/raw نشانی شما، /json همان شیء /my-ip و /country کد کشور تخمینی شما را نشان می‌دهد.

هر نقطهٔ پایانی مسیری یک شکل پرس‌وجویی هم دارد: /ip/lookup?ip=، /asn/lookup?asn=، /dns/lookup?name=، /network/cidr?cidr=. هر پاسخ سرآیند X-Request-Id دارد.

curl ipaddress.tr/rawcurl ipaddress.tr/jsoncurl ipaddress.tr/country

محدودیت نرخ

درخواست‌ها برای هر نشانی کلاینت با سطل توکن محدود می‌شوند. با رسیدن به حد، API کد ۴۲۹ را با سرآیند Retry-After برمی‌گرداند. شمارش در حافظه با کلید درهم‌سازی‌شده‌ای انجام می‌شود که روزانه عوض می‌شود؛ نشانی‌ها ذخیره نمی‌شوند.

خطاها

خطاها از کدهای وضعیت HTTP و بدنهٔ JSON به شکل {"error": {"code": "…", "message": "…"}} استفاده می‌کنند.

نسخه‌ها

مسیرهای زیر /api/v1/ ساختار پاسخ خود را حفظ می‌کنند. ممکن است فیلدهای تازه افزوده شوند؛ فیلدهای موجود در v1 حذف یا تغییر نام داده نمی‌شوند.

ذکر منبع

دادهٔ موقعیت از DB-IP (CC BY 4.0) می‌آید. اگر آن را نمایش می‌دهید، همان‌طور که مجوز می‌خواهد از DB-IP نام ببرید.