الحزم والمكتبات

Gurdx واجهة HTTPS وJSON عادية، فلا تحتاج إلى حزمة خاصة: أي عميل HTTP يعمل. الأمثلة التالية هي أصغر استدعاء يعمل في كل لغة.

cURL#

curl "https://gurdx.cretip.com/api/lookup/ip?ip=8.8.8.8&key=YOUR_API_KEY"

PHP (عميل HTTP في Laravel)#

use Illuminate\Support\Facades\Http;

$result = Http::acceptJson()
    ->withToken(env('GURDX_KEY'))
    ->get('https://gurdx.cretip.com/api/scoring/email', ['email' => 'user@example.com'])
    ->json();

JavaScript (fetch)#

const res = await fetch('https://gurdx.cretip.com/api/scoring/phone?phone=%2B966501234567&countryCode=SA', {
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
});
const data = await res.json();

Python (requests)#

import requests

r = requests.get("https://gurdx.cretip.com/api/lookup/bin", params={"bin": "411111", "key": "YOUR_API_KEY"}, timeout=5)
print(r.json())

عادات جيدة#

• أبقِ المفتاح على خادمك. لا تضعه في كود المتصفح أو الجوال؛ استخدم النطاقات المصرّح بها إن اضطررت للاستدعاء من المتصفح.
• حدّد مهلة قصيرة وقرّر مسبقًا ماذا يفعل تطبيقك عند فشل الاستدعاء.
• استخدم مفتاح gx_test_ أو mode=test أثناء التطوير: مجاني ولا يُنشئ أحداثًا.
• أرسل userID ليُظهر السجل والأحداث من تسبّب بها.