> ## 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.

> أنشئ بسهولة نقاط نهاية REST API من استعلاماتك المحفوظة

# Query API endpoints

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

يتطلب بناء تطبيقات تفاعلية قائمة على البيانات أكثر من مجرد قاعدة بيانات سريعة، وبيانات منظَّمة جيدًا، واستعلامات محسَّنة.
فواجهتك الأمامية والخدمات المصغّرة تحتاج أيضًا إلى طريقة سهلة لاستهلاك البيانات التي تُرجعها تلك الاستعلامات، ويفضَّل أن يكون ذلك عبر واجهات برمجة تطبيقات منظَّمة جيدًا.

تتيح لك ميزة **Query API endpoints** إنشاء نقطة نهاية API مباشرةً من أي استعلام SQL محفوظ في ClickHouse Cloud Console.
وستتمكن من الوصول إلى نقاط نهاية API عبر HTTP لتنفيذ استعلاماتك المحفوظة دون الحاجة إلى الاتصال بخدمة ClickHouse Cloud عبر برنامج تشغيل native.

<div id="ip-access-control">
  ## التحكم في الوصول عبر IP
</div>

تلتزم Query API endpoints بقائمة السماح لعناوين IP على مستوى مفتاح API. وعلى غرار SQL Console، تمرِّر Query API endpoints الطلبات من داخل البنية التحتية لـ ClickHouse، لذا لا تنطبق إعدادات قائمة السماح لعناوين IP على مستوى الخدمة.

لتقييد العملاء الذين يمكنهم استدعاء Query API endpoints الخاصة بك:

<Steps>
  <Step>
    #### افتح إعدادات مفتاح API

    1. انتقل إلى ClickHouse Cloud Console → **Organization** → **API Keys**

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/NsYs7SP2OxfcRtxb/images/cloud/guides/query-endpoints/console-api-keys.png?fit=max&auto=format&n=NsYs7SP2OxfcRtxb&q=85&s=cb2b16d29f542d0a3c670fe85141f406" size="md" alt="مفاتيح API" width="866" height="804" data-path="images/cloud/guides/query-endpoints/console-api-keys.png" />

    2. انقر على **Edit** بجوار مفتاح API المستخدم لـ Query API endpoints

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/NsYs7SP2OxfcRtxb/images/cloud/guides/query-endpoints/api-key-edit.png?fit=max&auto=format&n=NsYs7SP2OxfcRtxb&q=85&s=91e6359406df4090b3c1d504e19aded8" size="md" alt="تحرير" width="2506" height="446" data-path="images/cloud/guides/query-endpoints/api-key-edit.png" />
  </Step>

  <Step>
    #### أضف عناوين IP المسموح بها

    1. في قسم **Allow access to this API Key**، حدِّد **Specific locations**
    2. أدخل عناوين IP أو نطاقات CIDR (على سبيل المثال، `203.0.113.1` أو `203.0.113.0/24`)
    3. أضف عدة إدخالات حسب الحاجة

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/NsYs7SP2OxfcRtxb/images/cloud/guides/query-endpoints/specific-locations.png?fit=max&auto=format&n=NsYs7SP2OxfcRtxb&q=85&s=89773febb48a97748429fc65ee3a797d" size="md" alt="مواقع محددة" width="1336" height="1740" data-path="images/cloud/guides/query-endpoints/specific-locations.png" />

    يتطلب إنشاء Query API endpoints دور Admin في Console ومفتاح API يملك الأذونات المناسبة.
  </Step>
</Steps>

<Tip>
  **دليل**

  راجع [دليل Query API endpoints](/ar/products/cloud/guides/sql-console/query-endpoints) للحصول على إرشادات حول كيفية إعداد
  Query API endpoints في بضع خطوات سهلة
</Tip>