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

> Créez facilement des endpoints d’API REST à partir de vos requêtes enregistrées

# Query API endpoints

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

Créer des applications interactives axées sur les données nécessite non seulement une base de données rapide, des données bien structurées et des requêtes optimisées.
Votre front-end et vos microservices ont également besoin d’un moyen simple d’exploiter les données renvoyées par ces requêtes, de préférence via des API bien structurées.

La fonctionnalité **Query API Endpoints** vous permet de créer un endpoint d’API directement à partir de n’importe quelle requête SQL enregistrée dans la console ClickHouse Cloud.
Vous pourrez accéder à ces endpoints d’API via HTTP pour exécuter vos requêtes enregistrées, sans avoir à vous connecter à votre service ClickHouse Cloud à l’aide d’un driver natif.

<div id="ip-access-control">
  ## Contrôle d’accès IP
</div>

Les Query API endpoints appliquent la liste d’autorisation d’IP définie au niveau de la clé API. Comme pour la SQL Console, les Query API endpoints font transiter les requêtes via l’infrastructure de ClickHouse, de sorte que les paramètres de liste d’autorisation IP au niveau du service ne s’appliquent pas.

Pour limiter les clients autorisés à appeler vos Query API endpoints :

<Steps>
  <Step>
    #### Ouvrir les paramètres de la clé API

    1. Accédez à ClickHouse Cloud Console → **Organization** → **API Keys**

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/0hBOxpNzeJRe9LGe/images/cloud/guides/query-endpoints/console-api-keys.png?fit=max&auto=format&n=0hBOxpNzeJRe9LGe&q=85&s=941859e3cbd971f4b29823df2a5d9225" size="md" alt="Clés API" width="866" height="804" data-path="images/cloud/guides/query-endpoints/console-api-keys.png" />

    2. Cliquez sur **Edit** à côté de la clé API utilisée pour les Query API endpoints

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/0hBOxpNzeJRe9LGe/images/cloud/guides/query-endpoints/api-key-edit.png?fit=max&auto=format&n=0hBOxpNzeJRe9LGe&q=85&s=dd4559a36c927e671d7395387e3ea2f3" size="md" alt="Modifier" width="2506" height="446" data-path="images/cloud/guides/query-endpoints/api-key-edit.png" />
  </Step>

  <Step>
    #### Ajouter des adresses IP autorisées

    1. Dans la section **Allow access to this API Key**, sélectionnez **Specific locations**
    2. Saisissez des adresses IP ou des plages CIDR (par ex. `203.0.113.1` ou `203.0.113.0/24`)
    3. Ajoutez autant d’entrées que nécessaire

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/0hBOxpNzeJRe9LGe/images/cloud/guides/query-endpoints/specific-locations.png?fit=max&auto=format&n=0hBOxpNzeJRe9LGe&q=85&s=4e62a387a800b5129fbcfcd98c249a01" size="md" alt="Emplacements spécifiques" width="1336" height="1740" data-path="images/cloud/guides/query-endpoints/specific-locations.png" />

    La création de Query API endpoints nécessite un rôle Admin dans la Console et une clé API disposant des autorisations appropriées.
  </Step>
</Steps>

<Tip>
  **Guide**

  Consultez le [guide des Query API endpoints](/fr/products/cloud/guides/sql-console/query-endpoints) pour savoir comment configurer
  des Query API endpoints en quelques étapes simples
</Tip>