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

> Crie facilmente endpoints de API REST a partir de consultas salvas

# Query API endpoints

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

Criar aplicações interativas orientadas por dados exige não apenas um banco de dados rápido, dados bem estruturados e consultas otimizadas.
Seu front-end e seus microsserviços também precisam de uma maneira fácil de consumir os dados retornados por essas consultas, de preferência por meio de APIs bem estruturadas.

O recurso **Query API Endpoints** permite que você crie um endpoint de API diretamente de qualquer consulta SQL salva no console do ClickHouse Cloud.
Você poderá acessar endpoints de API via HTTP para executar suas consultas salvas sem precisar se conectar ao seu serviço ClickHouse Cloud por meio de um driver nativo.

<div id="ip-access-control">
  ## Controle de acesso por IP
</div>

Os Query API endpoints respeitam a lista de IPs permitidos no nível da API key. Assim como no SQL Console, os Query API endpoints fazem proxy das solicitações de dentro da infraestrutura do ClickHouse, portanto as configurações de lista de IPs permitidos no nível do service não se aplicam.

Para restringir quais clientes podem chamar seus Query API endpoints:

<Steps>
  <Step>
    #### Abra as configurações da API key

    1. Vá para ClickHouse Cloud Console → **Organization** → **API Keys**

    <Image img="https://mintcdn.com/private-7c7dfe99-home-button/QFSnpjldnDouvOz3/images/cloud/guides/query-endpoints/console-api-keys.png?fit=max&auto=format&n=QFSnpjldnDouvOz3&q=85&s=c1e38ab78701c6e1e867303d710d69ea" size="md" alt="API Keys" width="866" height="804" data-path="images/cloud/guides/query-endpoints/console-api-keys.png" />

    2. Clique em **Edit** ao lado da API key usada para Query API endpoints

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

  <Step>
    #### Adicione os endereços IP permitidos

    1. Na seção **Allow access to this API Key**, selecione **Specific locations**
    2. Insira endereços IP ou intervalos CIDR (por exemplo, `203.0.113.1` ou `203.0.113.0/24`)
    3. Adicione várias entradas conforme necessário

    <Image img="https://mintcdn.com/private-7c7dfe99-home-button/QFSnpjldnDouvOz3/images/cloud/guides/query-endpoints/specific-locations.png?fit=max&auto=format&n=QFSnpjldnDouvOz3&q=85&s=eeef036db2bc4f1bdd991f079fd81131" size="md" alt="Specific locations" width="1336" height="1740" data-path="images/cloud/guides/query-endpoints/specific-locations.png" />

    A criação de Query API endpoints exige uma Role Admin no Console e uma API key com as permissões adequadas.
  </Step>
</Steps>

<Tip>
  **Guia**

  Consulte o [guia de Query API endpoints](/pt-BR/products/cloud/guides/sql-console/query-endpoints) para ver instruções de como configurar
  Query API endpoints em algumas etapas simples
</Tip>