المصادقة ومفاتيح API
كيف ترسل مفتاح API، وكم مفتاحًا يمكنك الاحتفاظ به، وما يستطيع المفتاح فعله وما لا يستطيعه، وما تفعله إذا تسرّب مفتاح، وكيف تلغي ربط مساعد ذكاء اصطناعي.
أرسل المفتاح في الترويسة Authorization
Authorization: Bearer YOUR_API_KEYهذه الترويسة هي المكان الوحيد الذي تقرأ منه الـ API المفتاح.
- لا تضع المفتاح أبدًا في عنوان URL (
?api_key=…). فعناوين URL ينتهي بها المطاف في السجلات، وفي سجل المتصفح، وفي الروابط المشتركة. وترفض الـ API مثل هذا الطلب بالرمز400 api_key_in_query. اعتبر ذلك المفتاح مكشوفًا: أبطله وأنشئ مفتاحًا جديدًا. - استدعِ
https://gloriads.com/api/v1بالضبط: فالعميل الذي يتبع إعادة توجيه إلى عنوان آخر يُسقط مفتاحك في الطريق. - استدعِ الـ API من جدول بيانات أو برنامج نصي أو خادم، لا من شيفرة صفحة ويب: فأي زائر للصفحة يستطيع قراءة المفتاح.
ما يستطيع المفتاح فعله
- قراءة حسابك، في كل نقاط النهاية.
- لا يغيّر شيئًا. فالـ API للقراءة فقط.
- يتشارك حدود حسابك: كل مفاتيحك ومساعدي الذكاء الاصطناعي المربوطين تُحتسب معًا، لذا لا يمنحك مفتاح ثانٍ طلبات إضافية. راجع الحدود والأخطاء.
إنشاء مفتاح
الإعدادات ← API ← إنشاء مفتاح.
- يمكن أن يصل الاسم إلى 40 حرفًا. استخدم اسم الأداة، لتعرف لاحقًا أي مفتاح تبطله.
- يُعرض المفتاح مرة واحدة. لا نحتفظ إلا ببصمة له، فلا أحد يستطيع عرضه مرة أخرى، ولا حتى نحن. احفظه في مدير كلمات مرور أو في الإعدادات السرية لأداتك.
- يمكنك الاحتفاظ بـ 10 مفاتيح في الوقت نفسه.
- لا يستطيع حساب العرض التوضيحي العام إنشاء مفاتيح.
قائمة المفاتيح
يُظهر كل مفتاح اسمه، وأحرفه الأولى (key_live_ab12…)، وتاريخ إنشائه، وآخر استخدام له.
يُحدَّث « آخر استخدام » مرة واحدة في الساعة على الأكثر، لذا قد يُظهر مفتاح استُخدم قبل دقائق وقتًا أقدم.
إبطال مفتاح
افتح قائمة ⋯ الخاصة بالمفتاح، ثم إبطال.
يسري ذلك فورًا: يتلقى الطلب التالي بذلك المفتاح 401 unauthorized، وهي الإجابة نفسها
التي يتلقاها مفتاح لم يوجد قط. ولا يمكن استعادة المفتاح المُبطَل: أنشئ مفتاحًا جديدًا.
مساعدو الذكاء الاصطناعي المربوطون دون مفتاح
لا يستخدم claude.ai وChatGPT أي مفتاح: تسجّل الدخول إلى Gloriads من المساعد وتنقر على سماح. فيحصل المساعد على وصول خاص به، لا يتيح إلا القراءة. ولمعرفة كيفية ربط مساعد: ربط مساعد ذكاء اصطناعي.
- الإعدادات ← API ← التطبيقات المتصلة تسرد كل مساعد، والعنوان الذي طلب الوصول، وتاريخ ربطه، وآخر مرة قرأ فيها حسابك (يُحدَّث مرة واحدة في الساعة على الأكثر).
- غير موثّق بجوار الاسم يعني أن التطبيق سجّل نفسه دون إثبات عنوانه. لا تُبقِ عليه إلا إذا كنت أنت من ربطه.
- لإيقاف أحدها، افتح قائمة ⋯ الخاصة به، ثم إلغاء الربط. ويسري ذلك فورًا. ولاستخدامه مجددًا، اربطه من جديد من المساعد.
عند رفض طلب
| الإجابة | السبب | ما العمل |
|---|---|---|
401 unauthorized | لا توجد ترويسة Authorization، أو المفتاح خاطئ أو مُبطَل | تحقق من الترويسة ومن المفتاح |
403 subscription_inactive | انتهى اشتراكك | اشترك من الإعدادات ← الفوترة |
400 api_key_in_query | كان المفتاح في عنوان URL | انقله إلى الترويسة، ثم أبطله |
كل الرموز الأخرى موصوفة في الحدود والأخطاء.
مفتاح العرض التوضيحي العام
يملأ مرجع API زر Try it مسبقًا بمفتاح عام. وهو لا يقرأ إلا حساب العرض التوضيحي، ومحدود بـ 10 طلبات في الدقيقة، يتشاركها كل الزوار. ولا يستطيع قراءة حسابك: استخدم مفتاحك الخاص لذلك.