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

# Administrar claves de API

> ClickHouse Cloud proporciona una API basada en OpenAPI que le permite administrar mediante programación su cuenta y ciertos aspectos de sus servicios.

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

ClickHouse Cloud proporciona una API basada en OpenAPI que le permite administrar mediante programación su cuenta y ciertos aspectos de sus servicios.

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

<Steps>
  <Step title="Abra la página API Keys">
    Puede usar la pestaña **API Keys** del menú de la izquierda para crear y administrar sus claves de API.

    <Image img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/mdxdaQfuAUyLnMk3/images/cloud/manage/openapi1.webp?fit=max&auto=format&n=mdxdaQfuAUyLnMk3&q=85&s=6cba69344e38d4bcc4d9385a702f6dcb" size="sm" alt="Pestaña API Keys" border width="433" height="472" data-path="images/cloud/manage/openapi1.webp" />
  </Step>

  <Step title="Empiece a crear una clave de API">
    La página **API Keys** mostrará inicialmente un mensaje para crear su primera clave de API, como se muestra a continuación. Después de crear su primera clave, puede crear nuevas claves con el botón `New API Key` que aparece en la esquina superior derecha.

    <Image img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/Py9QrBolpS4H74Ee/images/cloud/manage/openapi2.webp?fit=max&auto=format&n=Py9QrBolpS4H74Ee&q=85&s=853102ac3d22ea8539fe061ed4489135" size="md" alt="Página API Keys" border width="1036" height="466" data-path="images/cloud/manage/openapi2.webp" />
  </Step>

  <Step title="Configure la clave de API">
    Especifique el nombre de la clave, sus permisos y el tiempo de expiración.

    <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 al Service Role acceso a `Query Endpoints`.
    </Tip>

    <Image img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/Py9QrBolpS4H74Ee/images/cloud/manage/openapi3.png?fit=max&auto=format&n=Py9QrBolpS4H74Ee&q=85&s=70a5198eb821af39e9973f1c420e8317" size="md" alt="Formulario para crear una clave de API" border width="661" height="410" data-path="images/cloud/manage/openapi3.png" />
  </Step>

  <Step title="Agregue direcciones IP permitidas">
    Para restringir qué clientes pueden usar la clave de API, en la sección **Allow access to this API Key**, seleccione **Specific locations**. Introduzca una dirección IP o un rango CIDR, como `203.0.113.1` o `203.0.113.0/24`, y agregue entradas adicionales según sea necesario.

    Los Query API endpoints respetan las listas de IP permitidas a nivel de clave de API. Como las solicitudes se enrutan mediante proxy desde la infraestructura interna de ClickHouse, las listas de IP permitidas a nivel de servicio no se aplican. Consulte [IP Access Control](/es/cloud/features/query-api-endpoints#ip-access-control) para obtener más información.

    <Image img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/Cinr8kZ2dAyzpJvw/images/cloud/guides/query-endpoints/specific-locations.webp?fit=max&auto=format&n=Cinr8kZ2dAyzpJvw&q=85&s=20045c474dc3e3852d8b78c55f94513f" size="md" alt="Direcciones IP permitidas configuradas para una clave de API" border width="1336" height="1740" data-path="images/cloud/guides/query-endpoints/specific-locations.webp" />

    Haga clic en **Generate API Key** cuando haya terminado de configurar la clave.
  </Step>

  <Step title="Guarde las credenciales de la clave de API">
    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 no volverán a mostrarse después de salir de esta pantalla.

    <Image img="https://mintcdn.com/private-7c7dfe99-revert-104359-revert-104251-parquet-single/Py9QrBolpS4H74Ee/images/cloud/manage/openapi4.webp?fit=max&auto=format&n=Py9QrBolpS4H74Ee&q=85&s=78826f8a908161db3b3045dc633416c7" size="md" alt="Detalles de la clave de API" border width="653" height="271" data-path="images/cloud/manage/openapi4.webp" />
  </Step>

  <Step title="Autentique las solicitudes de API">
    La ClickHouse Cloud API usa [autenticación básica 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 ClickHouse Cloud API con `curl`:

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

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

  <Step title="Administre las claves de API existentes">
    Al volver a la página **API Keys**, verá el nombre de la clave, los últimos cuatro caracteres del ID de clave, los permisos, el estado, la fecha de expiración y el creador. Desde esta pantalla puede editar el nombre de la clave, los permisos y la expiración. También puede deshabilitar o eliminar claves desde esta pantalla.

    <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-revert-104359-revert-104251-parquet-single/Py9QrBolpS4H74Ee/images/cloud/manage/openapi5.webp?fit=max&auto=format&n=Py9QrBolpS4H74Ee&q=85&s=8cb2be0bc759a7d78375e9bb1aff9e92" size="md" alt="Página de administración de API Keys" border width="1092" height="335" data-path="images/cloud/manage/openapi5.webp" />
  </Step>
</Steps>

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

Para obtener más información sobre los endpoints, consulta la [Referencia de la API](/es/products/cloud/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`.