توثيق واجهة برمجة تطبيقات تحديد الموقع الجغرافي لعنوان IP

واجهة REST API لتحديد الموقع الجغرافي لـ IP. تتكون من مستوى مجاني للمدينة ومستوى مدفوع بمفتاح مصادقة للبيانات الكاملة. See pricing.

نقطة نهاية مجانية

تحديد الموقع على مستوى المدينة بدون الحاجة لمفتاح. حد الاستخدام هو 500 طلب يومياً لكل IP.

GET /api/v2/free/{ip}
GET /api/v2/free/{ip}/{field}   # single field as text/plain

~$ curl https://www.proxydocker.com/api/v2/free/8.8.8.8
{
    "ipAddress": "8.8.8.8",
    "continentCode": "NA",
    "continentName": "North America",
    "countryCode": "US",
    "countryName": "United States",
    "stateProv": "California",
    "city": "Mountain View"
}

~$ curl https://www.proxydocker.com/api/v2/free/8.8.8.8/countryName
United States

نقطة نهاية مدفوعة (Paid endpoint)

بيانات كاملة تتضمن الإحداثيات، مزود الخدمة/رقم الشبكة المستقلة (ISP/ASN)، واكتشاف البروكسي. قم بالمصادقة باستخدام مفتاح API الخاص بك في المسار. 150000 طلب شهرياً.

GET /api/v2/{apikey}/{ip}
GET /api/v2/{apikey}/{ip}/{field}

~$ curl https://www.proxydocker.com/api/v2/YOUR_API_KEY/8.8.8.8
{
    "ipAddress": "8.8.8.8",
    "continentCode": "NA",
    "continentName": "North America",
    "countryCode": "US",
    "countryName": "United States",
    "stateProv": "California",
    "city": "Mountain View",
    "zipCode": "94043",
    "timeZone": "America/Los_Angeles",
    "latitude": 37.42,
    "longitude": -122.08,
    "currencyCode": "USD",
    "asNumber": 15169,
    "asOrganization": "Google LLC",
    "isProxy": false
}

حقول الاستجابة

الحقل	المستوى	وصف
ipAddress	مجان	عنوان IP المستعلم عنه.
continentCode / continentName	مجان	القارة.
countryCode / countryName	مجان	رمز الدولة وفق معيار ISO واسمها.
stateProv / city	مجان	المنطقة والمدينة.
latitude / longitude	أساسي	الإحداثيات.
zipCode / timeZone / currencyCode	أساسي	الرمز البريدي، المنطقة الزمنية، والعملة.
asNumber / asOrganization	أساسي	النظام المستقل ومزود خدمة الإنترنت.
isProxy	أساسي	ما إذا كان IP يمثل بروكسي معروفاً.

الحصول على مفتاح API الخاص بك

اشترك في الخطة الأساسية عبر offers page. يظهر مفتاحك هناك فور اكتمال عملية الدفع، ويمكنك إعادة إنشائه في أي وقت.