API
البيانات نفسها التي يعرضها الموقع، بصيغة JSON أو نص عادي. دون مفتاح ودون حساب؛ وتُطبَّق حدود للاستخدام العادل.
curl https://ipaddress.ae/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/1.1.1.1 | بيانات الشبكة والتوجيه والسجل والموقع لعنوان ما. | بياناتنا الخاصة | 30 · 30/دقيقة |
POST/api/v1/bulkcurl --data-binary $'1.1.1.1\n9.9.9.9' https://ipaddress.ae/api/v1/bulk | حتى 100 عنوان دفعة واحدة (JSON بالشكل {"addresses": […]} أو عنوان في كل سطر)، يُجاب عنها من بياناتنا الخاصة فقط. لا يُخزَّن شيء. | بياناتنا الخاصة | 6 · 3/دقيقة |
| GET/api/v1/asn/{asn}جرّبه: /api/v1/asn/AS5384 | الجهة المالكة والسجل والبادئات المعلنة لنظام مستقل. | بياناتنا الخاصة | 30 · 30/دقيقة |
| GET/api/v1/dns/{domain}?type=A,MXجرّبه: /api/v1/dns/internetnz.nz?type=A,MX | سجلات DNS المباشرة لنطاق ما. | استعلام مباشر | 40 · 60/دقيقة |
| GET/api/v1/rdap/{query}جرّبه: /api/v1/rdap/AS5384 | بيانات التسجيل من خادم RDAP المختص. | استعلام مباشر | 10 · 6/دقيقة |
| GET/api/v1/healthجرّبه: /api/v1/health | مدى توفّر الخدمة. | بياناتنا الخاصة | 120 · 240/دقيقة |
| GET/api/v1/data-statusجرّبه: /api/v1/data-status | عمر كل مجموعة بيانات وحجمها. | بياناتنا الخاصة | 120 · 240/دقيقة |
حدود المعدل
تُحدّ الطلبات لكل عنوان عميل باستخدام دلو الرموز (token bucket). عند بلوغ الحد تجيب الواجهة بالرمز 429 مع ترويسة Retry-After. تُحسب الحدود في الذاكرة بمفتاح مُجزّأ (hash) يتغيّر يومياً؛ ولا تُخزَّن العناوين.
الأخطاء
تستخدم الأخطاء رموز حالة HTTP ونص JSON بالشكل {"error": {"code": "…", "message": "…"}}.
الإصدارات
تحافظ المسارات ضمن /api/v1/ على شكل استجاباتها. قد تُضاف حقول جديدة، لكن الحقول الحالية لا تُحذف ولا يُعاد تسميتها ضمن v1.
الإسناد
تأتي بيانات الموقع من DB-IP (CC BY 4.0). إن عرضتها، فاذكر DB-IP كما تشترط الرخصة.