واجهة برمجة تطبيقات للمطورين
معلومات 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 } }
]
}
}أكواد الأخطاء
| الحالة | الكود | المعنى |
|---|---|---|
| 400 | invalid_input | فشل التحقق من صحة معامل المسار أو الاستعلام. |
| 401 | missing_key | لم يتم توفير ترويسة Authorization. |
| 401 | invalid_key | المفتاح غير معروف أو تم إلغاؤه. |
| 429 | rate_limited | تم تجاوز الحصة اليومية. |
| 502 | resolve_failed | فشل الاستعلام من الخادم المصدر؛ يرجى إعادة المحاولة لاحقًا. |