واجهة برمجة تطبيقات للمطورين

معلومات IP على بعد طلب REST واحد

بيانات الموقع الجغرافي وسجلات DNS واكتشاف البروكسي/VPN/Tor عبر واجهة JSON API نظيفة. وثّق هويتك بمفتاح Bearer وابدأ العمل.

توثيق Bearer

أرسل مفتاحك في ترويسة Authorization.

حدود سخية

100/يوم مجانًا، 10,000/يوم في خطة Pro.

JSON نظيف

بنية استجابة ثابتة { ok, data } وأكواد أخطاء واضحة.

التوثيق

أنشئ مفتاحًا من صفحة مفاتيح API وأرسله كرمز Bearer. تُعرض المفاتيح مرة واحدة فقط — احفظها في مكان آمن.

Authorization: Bearer mip_your_api_key

حدود الاستخدام

تحتوي كل استجابة على X-RateLimit-Limit وX-RateLimit-Remaining. تجاوز حصتك اليومية يُعيد الحالة 429 مع خطأ rate_limited.

نقاط النهاية

GET/api/v1/ip/{ip}

بيانات الموقع الجغرافي واكتشاف البروكسي/VPN/Tor لعنوان IP.

الطلب
curl https://myiplocation.org/api/v1/ip/8.8.8.8 \
  -H "Authorization: Bearer mip_your_api_key"
الاستجابة
{
  "ok": true,
  "data": {
    "ip": "8.8.8.8",
    "geo": {
      "city": "Mountain View",
      "region": "California",
      "country_code": "us",
      "country_name": "United States",
      "latitude": 37.4056,
      "longitude": -122.0775,
      "timezone": "America/Los_Angeles"
    },
    "privacy": {
      "is_proxy": false,
      "is_vpn": false,
      "is_tor": false,
      "is_datacenter": true,
      "risk_score": 20,
      "data_ready": true
    }
  }
}
GET/api/v1/dns?host={host}

سجلات A و AAAA و CNAME و MX و NS و TXT و SOA.

الطلب
curl "https://myiplocation.org/api/v1/dns?host=example.com" \
  -H "Authorization: Bearer mip_your_api_key"
الاستجابة
{
  "ok": true,
  "data": {
    "host": "example.com",
    "records": {
      "A": ["93.184.216.34"],
      "AAAA": [],
      "MX": [],
      "NS": ["a.iana-servers.net", "b.iana-servers.net"],
      "TXT": ["v=spf1 -all"]
    }
  }
}
GET/api/v1/proxy-check?ip={ip}

تحديد نوع البروكسي / VPN / Tor / مركز بيانات مع درجة خطورة.

الطلب
curl "https://myiplocation.org/api/v1/proxy-check?ip=1.2.3.4" \
  -H "Authorization: Bearer mip_your_api_key"
الاستجابة
{
  "ok": true,
  "data": {
    "ip": "1.2.3.4",
    "is_proxy": false,
    "is_vpn": false,
    "is_tor": false,
    "is_datacenter": true,
    "risk_score": 25,
    "signals": ["datacenter"],
    "data_ready": true
  }
}
POST/api/v1/bulk

بيانات موقع جغرافي واكتشاف بروكسي بالجملة لحتى 50 عنوان IP (لخطة Pro فقط).

الطلب
curl -X POST https://myiplocation.org/api/v1/bulk \
  -H "Authorization: Bearer mip_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"ips":["8.8.8.8","1.1.1.1"]}'
الاستجابة
{
  "ok": true,
  "data": {
    "count": 2,
    "results": [
      { "ip": "8.8.8.8", "geo": { "country_code": "us" }, "privacy": { "is_datacenter": true } }
    ]
  }
}

أكواد الأخطاء

الحالةالكودالمعنى
400invalid_inputفشل التحقق من صحة معامل المسار أو الاستعلام.
401missing_keyلم يتم توفير ترويسة Authorization.
401invalid_keyالمفتاح غير معروف أو تم إلغاؤه.
429rate_limitedتم تجاوز الحصة اليومية.
502resolve_failedفشل الاستعلام من الخادم المصدر؛ يرجى إعادة المحاولة لاحقًا.