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

# Gestion des clés API

> ClickHouse Cloud propose une API basée sur OpenAPI qui vous permet de gérer par programmation votre compte et certains aspects de vos services.

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

ClickHouse Cloud fournit une API basée sur OpenAPI qui vous permet de gérer par programmation votre compte et certains aspects de vos services.

<Note>
  Ce document couvre l’API ClickHouse Cloud. Pour les endpoints de l’API de base de données, veuillez consulter [Cloud Endpoints API](/fr/products/cloud/guides/sql-console/query-endpoints)
</Note>

1. Vous pouvez utiliser l’onglet **Clés API** dans le menu de gauche pour créer et gérer vos clés API.

<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="Onglet Clés API" border width="433" height="472" data-path="images/cloud/manage/openapi1.png" />

2. La page **Clés API** affiche au départ un message vous invitant à créer votre première clé API, comme illustré ci-dessous. Une fois cette première clé créée, vous pourrez en créer de nouvelles à l’aide du bouton `New API Key`, qui apparaît dans le coin supérieur droit.

<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="Page Clés API" border width="1036" height="466" data-path="images/cloud/manage/openapi2.png" />

3. Pour créer une clé API, indiquez le nom de la clé, ses autorisations et sa date d’expiration, puis cliquez sur `Generate API Key`.

<br />

<Note>
  Les autorisations correspondent aux [rôles prédéfinis](/fr/products/cloud/reference/security/console-roles) de ClickHouse Cloud. Le rôle developer dispose d’autorisations en lecture seule sur les services qui lui sont attribués, et le rôle admin dispose d’autorisations complètes en lecture et en écriture.
</Note>

<Tip>
  **Query API Endpoints**

  Pour utiliser des clés API avec les [Query API Endpoints](/fr/products/cloud/guides/sql-console/query-endpoints), définissez Organization Role sur `Member` (au minimum) et accordez à Service Role l’accès à `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="Formulaire de création de clé API" border width="661" height="410" data-path="images/cloud/manage/openapi3.png" />

4. L’écran suivant affichera votre ID de clé et le secret de la clé. Copiez ces valeurs et conservez-les dans un endroit sûr, comme un coffre-fort. Elles ne seront plus affichées après avoir quitté cet écran.

<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="Détails de la clé API" border width="653" height="271" data-path="images/cloud/manage/openapi4.png" />

5. L’API ClickHouse Cloud utilise l’[authentification HTTP Basic](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication) pour vérifier la validité de vos clés API. Voici un exemple montrant comment utiliser vos clés API pour envoyer des requêtes à l’API ClickHouse Cloud avec `curl` :

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

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

6. En revenant à la page **Clés API**, vous verrez le nom de la clé, les quatre derniers caractères de l’ID de clé, les permissions, le statut, la date d’expiration et le créateur. Depuis cet écran, vous pouvez modifier le nom de la clé, les permissions et la date d’expiration. Les clés peuvent également y être désactivées ou supprimées.

<br />

<Note>
  La suppression d’une clé API est une action permanente. Tous les services qui utilisent cette clé perdront immédiatement l’accès à 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="Page de gestion des clés API" border width="1092" height="335" data-path="images/cloud/manage/openapi5.png" />

<div id="endpoints">
  ## Endpoints
</div>

Pour en savoir plus sur les endpoints, consultez la [Référence API](/fr/api-reference/organization/get-list-of-available-organizations).
Utilisez votre clé API et votre secret API avec l’URL de base `https://api.clickhouse.cloud/v1`.