بيئة التطوير

ابنِ تكاملك واختبره مجاناً عبر وضع الاختبار، الذي لا يمسّ حصتك ولا سجل الأحداث لديك.

طريقتان لدخول وضع الاختبار#

1. استخدم مفتاحاً تجريبياً. المفاتيح التي تبدأ بـgx_test_ تعمل دائماً في وضع الاختبار.
2. أضف mode=test إلى طلب بأي مفتاح.

# بمفتاح تجريبي
curl "https://gurdx.cretip.com/api/lookup/ip?ip=1.1.1.1&key=gx_test_YOUR_TEST_KEY"

# بمفتاح فعلي مع إجبار وضع الاختبار لهذا الطلب
curl "https://gurdx.cretip.com/api/lookup/ip?ip=1.1.1.1&key=gx_live_YOUR_KEY&mode=test"

يقبل mode القيمتين live (الافتراضي) وtest، وغيرهما يعيد الخطأ 111 invalid_mode. ولا يمكن تحويل مفتاح تجريبي إلى فعلي بالقيمة mode=live.

ماذا يفعل وضع الاختبار#

لأن البيانات مولَّدة، لا تستخدم استجابات الاختبار للحكم على الدقة أو لاتخاذ قرارات حقيقية. استخدمها للتأكد من أن شيفرتك تقرأ الحقول وتعالج كل الحالات وتتصرف بشكل صحيح عند الأخطاء.

الفحوص ما زالت تعمل#

يُبقي وضع الاختبار البوابة قائمة. يحتاج الطلب إلى مفتاح صالح وحساب واشتراك فعّالين ومضيف مصرّح له ووصول إلى الدالة عبر خطتك وخيارات صحيحة. وتبقى المدخلات الناقصة أو الخاطئة تفشل بالأخطاء المعتادة، فتستطيع تجربة معالجة الأخطاء:

curl "https://gurdx.cretip.com/api/lookup/ip?ip=not-an-ip&key=gx_test_YOUR_TEST_KEY"

{
  "status": "error",
  "code": 112,
  "type": "invalid_ip",
  "description": "The IP Address is not valid or empty."
}

سير العمل الموصى به#

1. أنشئ مفتاحاً تجريبياً في لوحة التحكم (https://gurdx.cretip.com/app) واحفظه في ملف .env للتطوير.
2. اكتب تكاملك واختباراتك الآلية عليه.
3. بدّل إلى مفتاح gx_live_ في الإنتاج عبر الإعدادات.
4. احتفظ باختبار دخان صغير يستخدم mode=test مع المفتاح الفعلي للتأكد من الاتصال بعد النشر دون استهلاك الحصة.

Note: يبقى حد 1,000 طلب في الثانية مطبّقاً على طلبات الاختبار من الحساب نفسه.

راجع أيضاً مفاتيح الواجهة وحدود الاستخدام.