JSONP

لُفّ استجابة JSON داخل استدعاء دالة جافاسكربت ليمكن تحميلها بوسم script.

المعامل callback#

مرّر callback باسم الدالة التي ستستقبل البيانات.

curl "https://gurdx.cretip.com/api/geoip?key=YOUR_TEST_KEY&callback=handleGeo"

تُقدَّم الاستجابة بنوع application/javascript:

/**/handleGeo({"data":{"ip":"203.0.113.7","countryCode":"SA"},"status":"success","executionTime":9});

مثال في صفحة#

<script>
  function handleGeo(res) {
    if (res.status === "error") return console.warn(res.code, res.type);
    console.log(res.data.countryCode);
  }
</script>
<script src="https://gurdx.cretip.com/api/geoip?key=YOUR_TEST_KEY&callback=handleGeo"></script>

القواعد#

الأخطاء تُلفّ كذلك: تستقبل الدالة كائن الخطأ، فليفحص كودك الحقل status.

اعتبارات أمنية#

Warning: يضع JSONP مفتاحك في رابط سكربت يستطيع أي شخص قراءته من مصدر الصفحة. لا تستخدم مفتاحاً فعلياً بهذه الطريقة أبداً.

• استخدم مفتاح gx_test_ للعروض التجريبية، أو
• الأفضل أن تستدعي Gurdx من خادمك وتعرض النتيجة وحدها للمتصفح.

وإن اضطررت لاستدعاءات من المتصفح فقيّد المضيفين المصرّح لهم في الحساب بحيث لا يُقبل المفتاح إلا من مواقعك. راجع مفاتيح الواجهة. كما تستطيع المتصفحات الحديثة استدعاء الواجهة بـfetch لأن الاستجابات تسمح بالقراءة عبر النطاقات، فلا حاجة إلى JSONP في أغلب الحالات.

ذو صلة#

صيغة الاستجابة، رموز الأخطاء.