رموز API
يمكنك إنشاء الرموز المميزة لواجهة برمجة التطبيقات الشخصية وتدويرها وإبطالها في الإعدادات للبرامج النصية وعملاء MCP الذين يقومون بالمصادقة باسمك.
API tokens هي بيانات اعتماد شخصية يتم المصادقة عليها كـ you. استخدمها للبرامج النصية أو عملاء MCP عندما تحتاج إلى رمز مميز تتحكم فيه من الإعدادات.
افتح Settings من قائمة المستخدم (اسمك في أسفل يسار الشريط الجانبي)، ثم افتح علامة التبويب API tokens.
تظهر الرموز المميزة لواجهة برمجة التطبيقات (API) فقط عندما يتم تمكين الوصول إلى واجهة برمجة التطبيقات (API) في مؤسستك. المملوكة للمؤسسة service tokens موجودة في لوحة المشرف وحدة تحكم واجهة برمجة التطبيقات، وليس هنا.
إنشاء رمز مميز
- انتقل إلى Settings → API tokens
- انقر فوق Create token
- أدخل Name (على سبيل المثال،
Grafana ingestأوNightly scripts) - اختر Expiry (7 أو 30 أو 90 أو 365 يومًا)
- حدد Scope واحدًا على الأقل. لا يعرض المنتقي سوى النطاقات التي تتيحها خطتك ومؤسستك.
- قم بشكل اختياري بتعيين IP allowlist (SME وEnterprise). اتركه مفتوحًا إذا لم تكن بحاجة إلى تثبيت IP.
- اختياريًا pin الرمز المميز لمؤسستك الحالية. تتبع الرموز المميزة غير المثبتة مؤسستك النشطة عند التبديل (مفيدة لاستخدام MCP أو البرنامج النصي متعدد المؤسسات).
- انقر على Create token
- Copy the token immediately. يظهر PetroBench السر مرة واحدة فقط.
أي شيء يستخدم رمزًا مميزًا تم إبطاله أو تدويره يتوقف عن العمل على الفور.
إدارة الرموز
| العمل | ماذا يفعل |
|---|---|
| Revoke | يحذف الرمز المميز على الفور. لا يمكن التراجع. |
| Rotate | يلغي السر القديم ويصدر سرًا جديدًا بنفس النطاقات. تحديث كل عميل. |
| Rename | يغير اسم العرض. |
| Resume | يمسح الإيقاف المؤقت الشاذ (مسؤول القسم أو أعلى). |
قم بتصفية القائمة حسب Status (Active أو Expired). انقر على اسم الرمز المميز للنطاقات والقائمة المسموح بها لعناوين IP وانتهاء الصلاحية والتفاصيل الأخرى.
الرمز الشخصي مقابل رمز الخدمة مقابل التطبيقات المتصلة
| بيانات الاعتماد | أين | الأفضل لـ |
|---|---|---|
| Personal API token | الإعدادات → رموز API | أنت ومخطوطاتك |
| Service token | لوحة الإدارة → وحدة تحكم API → رموز الخدمة | التكاملات والوظائف التي يجب أن تستمر بعد عمر الشخص |
| Connected app (OAuth) | الإعدادات → التطبيقات المتصلة | مضيفو الذكاء الاصطناعي الذين يسجلون دخولك دون لصق سر |
حدود المعدل والتوقف المؤقت
إذا عادت المكالمات إلى 429، فافتح Admin Panel → API & Integrations → API Console → Usage، ثم راجع حدود السعر.
يمكن أن تتوقف الرموز المميزة مؤقتًا عند حدود الإنفاق اليومي أو الاستخدام غير الطبيعي. استأنف من صف الرمز المميز عندما يكون لديك إذن، أو اتصل بمسؤول القسم.