جلب عنوان IP (مجاني)

تُرجع عنوان IP العام للمتصل. لا حاجة إلى مفتاح API.

نظرة عامة#

https://gurdx.cretip.com/api/ip أبسط دالة في الـ API. تردّ بعنوان IP الذي جاء منه الطلب لا أكثر. وتحافظ الاستجابة على الغلاف المعتاد: العنوان في data يليه status وexecutionTime. ولأنها لا تحتاج مفتاحًا، يمكنك استدعاؤها مباشرة من متصفح أو سكربت أو جهاز دون أي بيانات اعتماد.

متى تستخدمها#

• لمعرفة العنوان العام الذي يستخدمه زائر أو جهاز، ثم تمريره إلى فحص عنوان IP من خادمك.
• لمعرفة العنوان الصادر لخادمك، مثلًا لإضافته إلى قائمة المضيفات المصرّح بها أو إلى قائمة سماح لدى شريك.
• لتشخيص إعدادات البروكسي أو NAT عبر رؤية العنوان الذي تلاحظه Gurdx.

إن أردت الموقع والتفاصيل الأمنية للمتصل في خطوة واحدة فاستخدم الموقع الجغرافي للزائر وهي تتطلب مفتاحًا.

آلية العمل#

تقرأ Gurdx عنوان الاتصال، مع احترام ترويسات التوجيه التي تضعها حافتها الخاصة، وتُرجعه نصًا بسيطًا. يدعم IPv4 وIPv6، فتعتمد القيمة على الطريقة التي وصل بها المتصل إلى الخدمة. وقد يُظهر العميل ثنائي المكدس عنوانًا مختلفًا في كل استدعاء.

ملاحظات#

• لا حاجة إلى مفتاح، والاستدعاء غير مُفوتر ولا يستهلك أي حصة.
• معدل الاستخدام محدود بـ 120 طلبًا في الدقيقة لكل عنوان IP. وعند تجاوزه تستلم استجابة HTTP 429 قياسية من محدّد المعدل لا غلاف أخطاء JSON، فتمهّل ثم أعد المحاولة.
• لا تطلق أحداثًا ولا تخضع للقواعد المخصصة أو القوائم السوداء.
• ولأنها مفتوحة للجميع، لا تعتبر النتيجة دليلًا على الهوية بل مجرد العنوان الذي رأته الخدمة.
• تعمل مع الخيارات المشتركة مثل format، فيمكنك طلب XML أو CSV أو JSONP إن ناسب عميلك.

الطلب#

• لا تحتاج مفتاح API.

تقبل كل خدمة أيضاً format, lang, mode, userID. راجع الخيارات.

أمثلة برمجية#

curl -G "https://gurdx.cretip.com/api/ip"

<?php

$response = file_get_contents('https://gurdx.cretip.com/api/ip?'.http_build_query([]));
$result = json_decode($response, true);

if ($result['status'] === 'success') {
    print_r($result['data']);
} else {
    echo $result['code'].': '.$result['description'];
}

const params = new URLSearchParams({});
const res = await fetch(`https://gurdx.cretip.com/api/ip?${params}`);
const result = await res.json();

if (result.status === 'success') {
  console.log(result.data);
} else {
  console.error(result.code, result.description);
}

import requests

res = requests.get("https://gurdx.cretip.com/api/ip", params={})
result = res.json()

if result["status"] == "success":
    print(result["data"])
else:
    print(result["code"], result["description"])

الاستجابة#

نجاح#

{
    "data": {
        "ip": "203.0.113.42",
        "ipType": "IPv4"
    },
    "status": "success",
    "executionTime": 0
}

خطأ#

تُسلَّم الأخطاء بحالة HTTP 200 — افحص دائماً حقل status.

{
    "status": "error",
    "code": 101,
    "type": "invalid_key",
    "description": "The API Key is missing or invalid."
}