المصادقة والمفاتيح

كل طلب يحمل مفتاحاً، وكل مفتاح يعود إلى مشروعٍ واحد تُحسب عليه الحدود والإنفاق.

رأس المصادقة

أرسل المفتاح في رأس Authorization بصيغة Bearer:

curl https://api.optes3.com/v1/chat/completions \  -H "Authorization: Bearer $OPTES_API_KEY" \  -H "Content-Type: application/json" \  -d '{"model": "optes-1.0-mini", "messages": [{"role": "user", "content": "مرحباً"}]}'

الطلب بلا مفتاح، أو بمفتاح ملغى أو خاطئ، يرجع برمز 401.

أنواع المفاتيح

البادئة الثابتة تجعل أدوات فحص الأسرار تكتشف المفتاح إن وصل إلى مستودع بالخطأ.

المشاريع

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

احفظ مفتاحك

• على الخادم فقط. لا تضعه في كود المتصفح أو تطبيق الهاتف أو مستودعٍ عام؛ اجعل خادمك يستدعي الواجهة نيابةً عنهما.
• في متغيّر بيئة أو مدير أسرار، لا في الكود.
• مفتاحٌ لكل خدمة، بأقل صلاحية تحتاجها، فتلغي واحداً دون أن توقف الباقي.
• دوّره كل 90 يوماً، وألغِه فوراً إن شككت أنه تسرّب. الإلغاء فوري.