---
title: البدء السريع | RunAPI
description: أنشئ مفاتيح API قياسية واحكم عليها وضع ضوابط حمايتها باستخدام مفتاح إدارة
  RunAPI.
url: https://runapi.ai/ar/docs/guides/platform-management/quickstart.md
canonical: https://runapi.ai/ar/docs/guides/platform-management/quickstart
locale: ar
---

> نسخة HTML: https://runapi.ai/ar/docs/guides/platform-management/quickstart
> فهرس الموقع للوكلاء: https://runapi.ai/llms.txt

# البدء السريع

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

## إنشاء مفتاح إدارة

اتبع [دليل المصادقة](https://runapi.ai/ar/docs/guides/authentication.md) لتسجيل
الدخول، ثم افتح صفحة Management Keys وأنشئ مفتاح إدارة.
احتفظ به بمعزل عن مفاتيح التطبيقات القياسية. أرسله كرمز bearer إلى نقاط نهاية Platform Management فقط.

```http
Authorization: Bearer YOUR_MANAGEMENT_KEY
```

لا يمكن لمفتاح API القياسي استدعاء نقاط نهاية إدارة المفاتيح أو الحراس.
قد يتلقى مفتاح الإدارة الصالح استجابة `403 Forbidden` حين لا يمتلك
مالكه دور الحساب المطلوب بعد الآن.

## سرد مفاتيح API القياسية

استخدم `GET /api/v1/keys` للاطلاع على المفاتيح المرئية لحساب مفتاح الإدارة:

```shell
curl "https://runapi.ai/api/v1/keys" \
  -H "Authorization: Bearer YOUR_MANAGEMENT_KEY"
```

استخدم المعرّفات العامة المُعادة لطلبات الاسترجاع أو التحديث أو الإلغاء أو تعيين الحواجز لاحقًا. لا تستنتج صلاحية الوصول من اسم المفتاح أو الرمز المخفي.

## إنشاء مفتاح وتدويره

أنشئ مفتاح تطبيق باستخدام `POST /api/v1/keys`. يُعاد السرّ الكامل
في استجابة الإنشاء فحسب، لذا احفظه في مدير الأسرار قبل تجاهل تلك
الاستجابة. يجب أن يُنشئ التدوير مفتاحاً بديلاً، وينشره في التطبيق،
ويتحقق من حركة المرور، ثم يُلغي المفتاح القديم.

```shell
curl -X POST "https://runapi.ai/api/v1/keys" \
  -H "Authorization: Bearer YOUR_MANAGEMENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Production worker"}'
```

`credit_limit_windows` يقبل أي مجموعة من حدود الإنفاق المتجددة `1h` و`1d` و`7d`. إذا استُنفدت أي نافذة مُهيَّأة، تُعيد الاستدعاءات ذات المفتاح المعني `429 Too Many Requests` حتى يخرج الاستخدام من تلك النافذة. أرسل كائنًا فارغًا عند تحديث مفتاح لمسح جميع الحدود المتجددة.

## تطبيق الحراس

Guardrails هي سياسات حساب قابلة لإعادة الاستخدام لضبط النموذج والمزود والإنفاق. أدر السياسات عبر `/api/v1/guardrails`، ثم استخدم `/api/v1/guardrail_assignments` لإرفاقها أو إزالتها. عامل التخصيص المرفوض باعتباره إخفاقاً في السياسة أو الملكية بدلاً من الاستمرار بصمت دون guardrail.

## معالجة أخطاء الإدارة

* `401 Unauthorized` تعني أن بيانات الاعتماد مفقودة أو مشوّهة أو ملغاة أو غير صالحة.
* `403 Forbidden` تعني أن فئة بيانات الاعتماد أو دور الحساب لا يمكنه تنفيذ هذه العملية.
* `404 Not Found` تعني أن المورد المطلوب غير مرئي للحساب المُصادَق عليه.
* `422 Unprocessable Content` تعني أن قيمة واحدة أو أكثر من القيم المُرسَلة تنتهك قاعدة موارد.

---

## المزيد من RunAPI

- [الرئيسية](https://runapi.ai/ar/.md)
- [كتالوج النماذج](https://runapi.ai/ar/models.md)
- [الأسعار](https://runapi.ai/ar/pricing.md)
- [مزودو الخدمة](https://runapi.ai/ar/models)
- [التوثيق](https://runapi.ai/ar/docs/guides)
- [حزم SDK](https://runapi.ai/ar/sdk.md)
- [CLI](https://runapi.ai/ar/cli.md)
- [خادم MCP](https://runapi.ai/ar/mcp.md)
- [Claude Code مقابل Cursor](https://runapi.ai/ar/claude-code-vs-cursor.md)
- [إعداد Cursor API](https://runapi.ai/ar/cursor-api-setup.md)
- [RunAPI مقابل OpenRouter](https://runapi.ai/ar/openrouter-alternative.md)
- [المؤسسات](https://runapi.ai/ar/contact.md)
- [اتصل بنا](https://runapi.ai/ar/contact.md)
- [الشروط](https://runapi.ai/ar/terms.md)
- [الخصوصية](https://runapi.ai/ar/privacy.md)
- [فهرس الموقع للوكلاء](https://runapi.ai/llms.txt)

التواصل: contact@runapi.ai

## البيانات المنظمة

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/ar",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/ar/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/ar",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/aricon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "TechArticle",
    "headline": "البدء السريع",
    "description": "أنشئ مفاتيح API قياسية واحكم عليها وضع ضوابط حمايتها باستخدام مفتاح إدارة RunAPI.",
    "url": "https://runapi.ai/ar/docs/guides/platform-management/quickstart",
    "mainEntityOfPage": "https://runapi.ai/ar/docs/guides/platform-management/quickstart"
  }
]
```