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

# Gestión de claves de API

> ClickHouse Cloud ofrece una API basada en OpenAPI que le permite gestionar mediante programación su cuenta y algunos aspectos de sus servicios.

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

ClickHouse Cloud ofrece una API basada en OpenAPI que le permite gestionar mediante programación su cuenta y algunos aspectos de sus servicios.

<Note>
  Este documento trata sobre la API de ClickHouse Cloud. Para los endpoints de API de la base de datos, consulte [Cloud Endpoints API](/es/products/cloud/guides/sql-console/query-endpoints)
</Note>

1. Puede usar la pestaña **claves de API** del menú de la izquierda para crear y gestionar sus claves de API.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/hIzR76_l6U8-lQLM/images/cloud/manage/openapi1.png?fit=max&auto=format&n=hIzR76_l6U8-lQLM&q=85&s=b00f0b4f0391fd038c91baae2dfdb728" size="sm" alt="Pestaña claves de API" border width="433" height="472" data-path="images/cloud/manage/openapi1.png" />

2. La página **claves de API** mostrará inicialmente una opción para crear su primera clave de API, como se muestra a continuación. Una vez creada la primera clave, podrá crear otras nuevas con el botón `New API Key`, que aparece en la esquina superior derecha.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/hIzR76_l6U8-lQLM/images/cloud/manage/openapi2.png?fit=max&auto=format&n=hIzR76_l6U8-lQLM&q=85&s=37646787aac0ecef6f8e5d897ce8450b" size="md" alt="Página claves de API" border width="1036" height="466" data-path="images/cloud/manage/openapi2.png" />

3. Para crear una clave de API, especifique el nombre de la clave, sus permisos y el tiempo de expiración, y luego haga clic en `Generate API Key`.

<br />

<Note>
  Los permisos se corresponden con los [roles predefinidos](/es/products/cloud/reference/security/console-roles) de ClickHouse Cloud. El rol de desarrollador tiene permisos de solo lectura para los servicios asignados, y el rol de administrador tiene permisos completos de lectura y escritura.
</Note>

<Tip>
  **Query API Endpoints**

  Para usar claves de API con [Query API Endpoints](/es/products/cloud/guides/sql-console/query-endpoints), establezca Organization Role en `Member` (como mínimo) y conceda acceso de Service Role a `Query Endpoints`.
</Tip>

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/hIzR76_l6U8-lQLM/images/cloud/manage/openapi3.png?fit=max&auto=format&n=hIzR76_l6U8-lQLM&q=85&s=c7668537d2628710b8d56f628bb88838" size="md" alt="Formulario para crear clave de API" border width="661" height="410" data-path="images/cloud/manage/openapi3.png" />

4. La siguiente pantalla mostrará su ID de clave y el secreto de la clave. Copie estos valores y guárdelos en un lugar seguro, como una bóveda. Estos valores dejarán de mostrarse cuando salga de esta pantalla.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/hIzR76_l6U8-lQLM/images/cloud/manage/openapi4.png?fit=max&auto=format&n=hIzR76_l6U8-lQLM&q=85&s=65f5066df4be769b0be1a1f0a75db290" size="md" alt="Detalles de la clave de API" border width="653" height="271" data-path="images/cloud/manage/openapi4.png" />

5. La API de ClickHouse Cloud utiliza [autenticación básica de HTTP](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication) para verificar la validez de sus claves de API. A continuación se muestra un ejemplo de cómo usar sus claves de API para enviar solicitudes a la API de ClickHouse Cloud con `curl`:

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

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

6. Al volver a la página de **Claves de API**, verá el nombre de la clave, los últimos cuatro caracteres del ID de la clave, los permisos, el estado, la fecha de vencimiento y el creador. Desde esta pantalla, puede editar el nombre de la clave, los permisos y la fecha de vencimiento. También puede desactivar o eliminar claves desde esta pantalla.

<br />

<Note>
  Eliminar una clave de API es una acción permanente. Cualquier servicio que use la clave perderá inmediatamente el acceso a ClickHouse Cloud.
</Note>

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/hIzR76_l6U8-lQLM/images/cloud/manage/openapi5.png?fit=max&auto=format&n=hIzR76_l6U8-lQLM&q=85&s=f08a928d4f9788eb2f1ef78d62146dc4" size="md" alt="Página de administración de claves de API" border width="1092" height="335" data-path="images/cloud/manage/openapi5.png" />

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

Para obtener más información sobre los endpoints, consulta la [Referencia de la API](/es/api-reference/organization/get-list-of-available-organizations).
Usa tu clave de API y tu secreto de API con la URL base `https://api.clickhouse.cloud/v1`.