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

# 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 endpoint 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-8c05c8a2/edZyd8dUn5NVy-Ij/images/cloud/manage/openapi1.png?fit=max&auto=format&n=edZyd8dUn5NVy-Ij&q=85&s=6411066eb8aff75ff94921819e1ae5bb" 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-8c05c8a2/edZyd8dUn5NVy-Ij/images/cloud/manage/openapi2.png?fit=max&auto=format&n=edZyd8dUn5NVy-Ij&q=85&s=beab653fb8664cb625098b5482f4a4ac" 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-8c05c8a2/edZyd8dUn5NVy-Ij/images/cloud/manage/openapi3.png?fit=max&auto=format&n=edZyd8dUn5NVy-Ij&q=85&s=ac947aab0a81a30a8f96e299391c8372" 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-8c05c8a2/edZyd8dUn5NVy-Ij/images/cloud/manage/openapi4.png?fit=max&auto=format&n=edZyd8dUn5NVy-Ij&q=85&s=b4a0e6ed71a6ddfd12b788159ba2b196" 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-8c05c8a2/edZyd8dUn5NVy-Ij/images/cloud/manage/openapi5.png?fit=max&auto=format&n=edZyd8dUn5NVy-Ij&q=85&s=2baa38019092a38cf40c9087dfc69ba6" 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`.