إنشاء مفتاح GetAPI.ONE API وحمايته

المتطلبات المسبقة

• سجّل الدخول إلى GetAPI.ONE وتأكد من إمكانية فتح وحدة التحكم.
• تحقق من وجود رصيد قابل للاستخدام أو باقة منطبقة على الحساب.
• حدد العميل أو المشروع الوحيد الذي سيستخدم المفتاح وأين سيُحفظ متغير البيئة السري.

• تسجيل الدخول
• مساعدة الحساب

إنشاء المفتاح

1. افتح مفاتيح API من قائمة وحدة التحكم واختر إنشاء مفتاح API.
2. أدخل اسمًا وصفيًا مثل العميل والبيئة، ولا تضع السر نفسه في الاسم.
3. اختر المجموعة المطلوبة للنموذج ونقطة النهاية المقصودين.
4. اضبط مفتاحًا واحدًا وصلاحية محددة وحصة تناسب الاستخدام المتوقع. راجع القيود المتقدمة فقط عندما يحتاجها العميل.
5. احفظ التغييرات وعد إلى قائمة المفاتيح.

• فتح مفاتيح API

النسخ والتخزين

بعد الإنشاء، تعرض القائمة اسم المفتاح وقيمته المخفية والمجموعة والحالة وإجراءات الإدارة. لا يُعرض مفتاح GetAPI.ONE مرة واحدة فقط؛ يمكنك نسخه مجددًا من القائمة ومواصلة إدارته.

export GETAPI_ONE_API_KEY="replace-with-your-private-key"

$env:GETAPI_ONE_API_KEY = "replace-with-your-private-key"

إقران المفتاح بعنوان ONE

التحقق دون كشف المفتاح

1. أعدّ عميلًا واحدًا أو اتبع دليل الطلب المباشر بعد استبدال نموذج المثال بعنصر دليل متوافق مع نقطة النهاية.
2. أرسل طلبًا أدنى تقبل دفع تكلفته فقط؛ لم يُرسل أي طلب أثناء إنتاج هذا الدليل.
3. تحقق من استجابة صالحة ومن سجل الطلب أو الاستخدام في وحدة التحكم. أخفِ المفتاح قبل حفظ مخرجات التشخيص.

• طلب API مباشر
• Codex CLI

الأخطاء والتدوير والإلغاء

• 401 / Unauthorized: انسخ المفتاح مجددًا، وأزل المسافات الزائدة، وتحقق من تفعيله وإقرانه بعنوان ONE.
• إذا لم يوجد النموذج أو رُفض الوصول: تحقق من إتاحته لمجموعة المفتاح ومن إعلانه دعم نقطة النهاية المستخدمة.
• خطأ الحصة أو الانتهاء: افحص حد المفتاح وصلاحيته قبل زيادتهما، وافحص الرصيد وحدود المعدل أيضًا.
• عند الاشتباه بالتسريب: عطّل المفتاح أو احذفه، وأنشئ بديلًا بأقل نطاق مطلوب، وحدّث العميل وتحقق من عدم إمكانية استخدام المفتاح القديم.

• استكشاف الأخطاء وإصلاحها
• الدعم