مفاتيح API
Docsمفاتيح API

مفاتيح API

أنشئ وأدر مفاتيح API للوصول البرمجي إلى RaxyProxy REST API.

إنشاء مفتاح

اذهب إلى لوحة التحكم → مفاتيح API وانقر على إنشاء مفتاح جديد. أعطه اسماً وصفياً (مثلاً، scraper-prod)، ثم انقر على توليد.

يُعرض مفتاحك مرة واحدة فقط — انسخه فوراً. لن يُعرض مجدداً. تتبع المفاتيح الصيغة التالية:

raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

البادئة raxy_ تتبعها 40 حرفاً عشوائياً من الحروف والأرقام.

استخدام المفتاح

مرر المفتاح كـ Bearer token في رأس Authorization لكل طلب API:

request.sh
curl https://raxyproxy.com/api/v1/account \
     -H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

المفاتيح محددة النطاق لحسابك — يمكنها سرد الباقات واسترداد الإحصاءات وتوليد سلاسل البروكسي. لا يمكنها تعديل إعدادات الحساب أو إجراء مدفوعات.

أفضل ممارسات الأمان

لا تُفصح عن مفتاح API أبداً

مفتاح API يمنح حق الوصول للقراءة إلى حسابك وبيانات اعتماد البروكسي. عامله كلمة مرور — احفظه في متغيرات البيئة أو مدير الأسرار، ولا تضعه أبداً في الكود المصدري أو المستودعات العامة.

  • استخدم مفتاحاً منفصلاً لكل تطبيق أو بيئة
  • احفظ المفاتيح في متغيرات البيئة (RAXY_API_KEY=raxy_xxx...)
  • أضف .env إلى .gitignore
  • دور المفاتيح دورياً أو فوراً بعد الاشتباه في تسريب
.env
RAXY_API_KEY=raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

إلغاء المفتاح

من لوحة التحكم → مفاتيح API، انقر على أيقونة الحذف بجانب المفتاح الذي تريد إلغاءه. الإلغاء فوري — أي طلب يستخدم هذا المفتاح سيتلقى استجابة 401 Unauthorized.

إذا اشتبهت في اختراق مفتاح، ألغِه فوراً وأنشئ مفتاحاً جديداً. جلسات البروكسي الحالية لن تتأثر — يُحجب الوصول إلى API فقط.