إنتقل إلى المحتوى الرئيسي

مفاتيح API

مفاتيح API مطلوبة لمصادقة الطلبات المرسلة إلى واجهات GPT Translator.

في هذه الصفحة​

قبل البدء​

تأكد من توفر ما يلي:

  1. حساب GPT Translator.
  2. إمكانية الوصول إلى لوحة تحكم API.
  3. بيئة على جانب الخادم لتخزين المفاتيح بأمان.

إنشاء مفتاح API​

  1. سجّل الدخول إلى حساب GPT Translator.
  2. افتح Developer API Keys في لوحة التحكم.
  3. انقر على إنشاء مفتاح API جديد.
  4. انسخ المفتاح الذي تم إنشاؤه فورًا.
  5. خزّنه في متغير بيئة على الخادم (على سبيل المثال: .env).

استخدام مفتاح API​

أرسل مفتاحك في ترويسة الطلب:

x-api-key: YOUR_API_KEY

إدارة المفاتيح​

  • إعادة إنشاء المفتاح: تُحدّث بيانات الاعتماد وتبطل المفتاح السابق.
  • حذف المفتاح: يعطّل الوصول إلى API باستخدام هذا المفتاح نهائيًا.
  • مصدر موحّد للحقيقة: احتفظ بسجل المفاتيح النشطة في مدير الأسرار.

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

هام

لا تكشف مفاتيح API مطلقًا في كود الواجهة الأمامية أو حزم المتصفح أو المستودعات العامة.

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

الأخطاء الشائعة​

  • 401 Unauthorized: مفتاح x-api-key مفقود أو غير صالح.
  • 403 Forbidden: المفتاح موجود لكن الوصول غير مسموح به.
  • 429 Too Many Requests: تم تجاوز معدل الطلبات.

الخطوات التالية​