> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-vortex-format.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Acesso programático à API com o Postman > Este guia ajudará você a testar a API do ClickHouse Cloud usando o Postman export const Image = ({img, alt, size = "lg"}) => { const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg"; return
{alt}
; }; Este guia ajudará você a testar a API do ClickHouse Cloud usando o [Postman](https://www.postman.com/product/what-is-postman/). O aplicativo Postman pode ser usado no navegador ou baixado para o computador.
### Criar uma conta
* Há contas gratuitas disponíveis em [https://www.postman.com](https://www.postman.com). Site do Postman
### Criar um espaço de trabalho
* Dê um nome ao espaço de trabalho e defina o nível de visibilidade. Criar espaço de trabalho
### Criar uma coleção
* No menu no canto superior esquerdo, abaixo de "Explore", clique em "Import": Explore > Import * Uma janela modal será exibida: Campo de URL da API * Insira o endereço da API: "[https://api.clickhouse.cloud/v1](https://api.clickhouse.cloud/v1)" e pressione 'Enter': * Selecione "Postman Collection" clicando no botão "Import": Collection > Import
### Interaja com a especificação da API do ClickHouse Cloud
* A "API spec for ClickHouse Cloud" agora aparecerá em "Collections" (navegação à esquerda). Importe sua API * Clique em "API spec for ClickHouse Cloud". No painel central, selecione a guia 'Authorization': Importação concluída
### Definir a autorização
* Use o menu suspenso para selecionar "Basic Auth": Autenticação básica * Insira o nome de usuário e a senha que você recebeu ao configurar suas chaves de API do ClickHouse Cloud: credenciais
### Habilite as variáveis
* [Variáveis](https://learning.postman.com/docs/sending-requests/variables/) permitem armazenar e reutilizar valores no Postman, facilitando os testes de API.
#### Defina o ID da organização e o ID do serviço
* Na "coleção", clique na aba "Variable" no painel central (a Base URL já terá sido definida pela importação anterior da API): * Abaixo de `baseURL`, clique no campo vazio "Add new value" e substitua pelos IDs da sua organização e do seu serviço: ID da organização e ID do serviço
## Teste as funcionalidades da API do ClickHouse Cloud
### Teste "GET list of available organizations"
* Em "OpenAPI spec for ClickHouse Cloud", expanda a pasta > V1 > organizations * Clique em "GET list of available organizations" e pressione, à direita, o botão azul "Send": Testar a recuperação das organizações * Os resultados retornados devem exibir os detalhes da sua organização com "status": 200. (Se você receber um "status" 400 sem informações da organização, sua configuração não está correta). Status
### Teste "GET detalhes organizacionais"
* Na pasta `organizationid`, navegue até "GET detalhes organizacionais": * No menu do painel central, em Params, um `organizationid` é obrigatório. Testar a recuperação de detalhes organizacionais * Edite esse valor para `orgid`, entre chaves: `{{orgid}}` (como esse valor foi definido anteriormente, um menu aparecerá com o valor): Enviar teste * Após clicar no botão "Save", clique no botão azul "Send" no canto superior direito da tela. Valor retornado * Os resultados retornados devem trazer seus detalhes organizacionais com "status": 200. (Se você receber um "status" 400 sem informações da organização, sua configuração não está correta).
### Teste "GET service details"
* Clique em "GET service details" * Edite os valores de `organizationid` e `serviceid` para `{{orgid}}` e `{{serviceid}}`, respectivamente. * Clique em "Save" e depois no botão azul "Send", à direita. Lista de serviços * Os resultados retornados devem exibir uma lista dos seus serviços e respectivos detalhes com "status": 200. (Se você receber "status": 400 sem informações dos serviços, sua configuração não está correta).