> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# إدارة مفاتيح واجهة برمجة تطبيقات

> يوفّر ClickHouse Cloud واجهة برمجة تطبيقات تستند إلى OpenAPI تتيح لك إدارة حسابك وبعض جوانب خدماتك برمجيًا.

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

يوفّر ClickHouse Cloud واجهة برمجة تطبيقات تستند إلى OpenAPI، وتتيح لك إدارة حسابك وبعض جوانب خدماتك برمجيًا.

<Note>
  يغطي هذا المستند واجهة برمجة تطبيقات ClickHouse Cloud. للاطلاع على نقاط نهاية واجهة برمجة تطبيقات قاعدة البيانات، يُرجى مراجعة [Cloud Endpoints API](/ar/products/cloud/guides/sql-console/query-endpoints)
</Note>

1. يمكنك استخدام علامة التبويب **مفاتيح واجهة برمجة تطبيقات** في القائمة اليمنى لإنشاء مفاتيح واجهة برمجة التطبيقات الخاصة بك وإدارتها.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/edZyd8dUn5NVy-Ij/images/cloud/manage/openapi1.png?fit=max&auto=format&n=edZyd8dUn5NVy-Ij&q=85&s=6411066eb8aff75ff94921819e1ae5bb" size="sm" alt="علامة التبويب مفاتيح واجهة برمجة تطبيقات" border width="433" height="472" data-path="images/cloud/manage/openapi1.png" />

2. ستعرض صفحة **مفاتيح واجهة برمجة تطبيقات** في البداية رسالةً تطلب منك إنشاء أول مفتاح واجهة برمجة تطبيقات، كما هو موضح أدناه. بعد إنشاء مفتاحك الأول، يمكنك إنشاء مفاتيح جديدة باستخدام زر `New API Key` الذي يظهر في الزاوية العلوية اليمنى.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/edZyd8dUn5NVy-Ij/images/cloud/manage/openapi2.png?fit=max&auto=format&n=edZyd8dUn5NVy-Ij&q=85&s=beab653fb8664cb625098b5482f4a4ac" size="md" alt="صفحة مفاتيح واجهة برمجة تطبيقات" border width="1036" height="466" data-path="images/cloud/manage/openapi2.png" />

3. لإنشاء مفتاح واجهة برمجة تطبيقات، حدِّد اسم المفتاح وأذونات المفتاح ووقت انتهاء الصلاحية، ثم انقر على `Generate API Key`.

<br />

<Note>
  تتوافق الأذونات مع [الأدوار المحددة مسبقًا](/ar/products/cloud/reference/security/console-roles) في ClickHouse Cloud. يمتلك دور المطوّر أذونات قراءة فقط للخدمات المعيّنة، بينما يمتلك دور المسؤول أذونات كاملة للقراءة والكتابة.
</Note>

<Tip>
  **Query API Endpoints**

  لاستخدام مفاتيح واجهة برمجة تطبيقات مع [Query API Endpoints](/ar/products/cloud/guides/sql-console/query-endpoints)، اضبط Organization Role على `Member` (كحد أدنى)، وامنح Service Role إمكانية الوصول إلى `Query Endpoints`.
</Tip>

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/edZyd8dUn5NVy-Ij/images/cloud/manage/openapi3.png?fit=max&auto=format&n=edZyd8dUn5NVy-Ij&q=85&s=ac947aab0a81a30a8f96e299391c8372" size="md" alt="نموذج إنشاء مفتاح واجهة برمجة تطبيقات" border width="661" height="410" data-path="images/cloud/manage/openapi3.png" />

4. ستعرض الشاشة التالية معرّف المفتاح وسرّ المفتاح. انسخ هاتين القيمتين واحفظهما في مكان آمن، مثل خزنة. لن تُعرض هذه القيم بعد مغادرة هذه الشاشة.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/edZyd8dUn5NVy-Ij/images/cloud/manage/openapi4.png?fit=max&auto=format&n=edZyd8dUn5NVy-Ij&q=85&s=b4a0e6ed71a6ddfd12b788159ba2b196" size="md" alt="تفاصيل مفتاح واجهة برمجة تطبيقات" border width="653" height="271" data-path="images/cloud/manage/openapi4.png" />

5. تستخدم واجهة برمجة تطبيقات ClickHouse Cloud [HTTP Basic Authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication) للتحقق من صحة مفاتيح واجهة برمجة تطبيقات الخاصة بك. إليك مثالًا على كيفية استخدام مفاتيح واجهة برمجة تطبيقات لإرسال طلبات إلى واجهة برمجة تطبيقات ClickHouse Cloud باستخدام `curl`:

```bash theme={null}
$ KEY_ID=mykeyid
$ KEY_SECRET=mykeysecret

$ curl --user $KEY_ID:$KEY_SECRET https://api.clickhouse.cloud/v1/organizations
```

6. بالعودة إلى صفحة **مفاتيح واجهة برمجة تطبيقات**، سترى اسم المفتاح، وآخر أربعة أحرف من معرّف المفتاح، والأذونات، والحالة، وتاريخ انتهاء الصلاحية، والمنشئ. يمكنك من هذه الشاشة تعديل اسم المفتاح، والأذونات، وتاريخ انتهاء الصلاحية. كما يمكنك أيضًا من هذه الشاشة تعطيل المفاتيح أو حذفها.

<br />

<Note>
  حذف مفتاح واجهة برمجة تطبيقات إجراء دائم. وستفقد أي خدمات تستخدم هذا المفتاح إمكانية الوصول إلى ClickHouse Cloud فورًا.
</Note>

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/edZyd8dUn5NVy-Ij/images/cloud/manage/openapi5.png?fit=max&auto=format&n=edZyd8dUn5NVy-Ij&q=85&s=2baa38019092a38cf40c9087dfc69ba6" size="md" alt="صفحة إدارة مفاتيح واجهة برمجة تطبيقات" border width="1092" height="335" data-path="images/cloud/manage/openapi5.png" />

<div id="endpoints">
  ## نقاط النهاية
</div>

للاطّلاع على تفاصيل نقاط النهاية، راجِع [مرجع واجهة برمجة التطبيقات](/ar/api-reference/organization/get-list-of-available-organizations).
استخدم مفتاح واجهة برمجة التطبيقات والسرّ الخاص بها مع عنوان URL الأساسي `https://api.clickhouse.cloud/v1`.