الدرس 2 من 4 · ٧ دقائق

أنشئ حسابًا ومفتاحًا

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

سجّل في phaseo.app باستخدام Google أو GitHub أو GitLab أو بريد إلكتروني وكلمة مرور. يبدأ كل حساب بمساحة عمل شخصية، وهي تكفي لمشروع صغير.

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

أنشئ مفتاحًا من الإعدادات ← مفاتيح API واختر إنشاء مفتاح. اختر مساحة العمل، وسمِّ المفتاح، واختر إعدادًا جاهزًا:

  • التطوير: سقف إنفاق يومي منخفض للتطبيقات المحلية والنماذج الأولية.
  • الإنتاج: بلا سقوف جاهزة. أضف حدودًا لاحقًا إذا احتجتها.
  • CI: سقف للطلبات للاختبارات والتقييمات ومهام الإصدار.
  • بيئة الاختبار: سقف صارم للعروض والتجارب والاختبارات المشتركة.

يمكن أن تكون للمفاتيح حدود يومية أو أسبوعية أو شهرية للطلبات والإنفاق. عند بلوغ الحد، تعيد الطلبات بهذا المفتاح 429 مع key_limit_exceeded.

يُعرض المفتاح مرة واحدة فقط. انسخه واحفظه في متغير بيئة:

export PHASEO_API_KEY="phaseo_v1_sk_..."

تعامل معه ككلمة مرور. اقرأه من PHASEO_API_KEY في الكود الذي يعمل على الخادم. لا تضعه أبدًا في كودك أو في مستودع أو في تطبيق متصفح أو جوال أو في محادثة مع شخص أو وكيل. استخدم مفتاحًا لكل تطبيق وبيئة، لتتمكن من استبدال واحد دون كسر الباقي، واحذف المفاتيح التي لم تعد تستخدمها.

تحقّق من فهمك

أين يجب أن يكون مفتاح Phaseo API الخاص بك؟

طبّق ما تعلّمته

تبني نموذجًا أوليًا يستدعي نموذجًا مدفوعًا داخل حلقة تكرار. تخشى أن يتسبب خطأ برمجي في فاتورة كبيرة خلال الليل. ماذا يمكنك أن تفعل عند إنشاء المفتاح؟

اعرض الإجابة

اختر الإعداد الجاهز «التطوير» أو «بيئة الاختبار»، وكلاهما يضع سقف إنفاق منخفضًا، أو ضع حدًا يوميًا للإنفاق على المفتاح. إذا بلغت الحلقة الحد، تعيد الطلبات 429 مع key_limit_exceeded بدلًا من إنفاق المزيد. واستخدم مفتاحًا منفصلًا للإنتاج.

الخلاصة

تملك مساحة عملك المفاتيح والرصيد. أنشئ مفتاحًا لكل تطبيق وبيئة، واحفظه في PHASEO_API_KEY على الخادم.

روابط ذات صلة

يُحفظ تقدّمك في هذا المتصفح.

آخر مراجعة: ١٧ نوفمبر ٢٠٢٦