> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Cliente

> O objeto central é o objeto Cliente, instanciado com uma chave de API. Este objeto representa uma conexão com o serviço Square Cloud e atua como interface para interagir com vários aspectos do serviço.

```python theme={null}
import squarecloud as square

cliente = square.Client(api_key='CHAVE_API')

async def exemplo():
    status_app = await cliente.app_status('id_aplicacao')
    print(status_app)
```

## Parâmetros:

* api\_key

`api_key: str`: Este é o parâmetro obrigatório ao instanciar o objeto Cliente.
Uma chave de API válida deve ser fornecida como uma string para que a autenticação seja realizada corretamente.

* debug

`debug: bool = True`: Este é um parâmetro opcional que controla o modo de depuração do
objeto Cliente. Quando definido como True, toda vez que uma requisição é feita, o objeto Cliente imprime
informações de depuração para facilitar a detecção e resolução de
problemas. No entanto, em ambientes de produção, é comum definir este parâmetro
como False para evitar a exibição de informações desnecessárias.
O valor padrão é True.

## Aplicação

Utilizando o \[Cliente], você pode obter um objeto (ou uma lista de
objetos) que representa sua aplicação. Este objeto será uma instância da
classe Application que você pode usar
para gerenciar sua aplicação de forma mais conveniente, sem precisar passar
o id da sua aplicação toda vez.

<Tabs>
  <Tab title="Obtendo uma aplicação">
    ```python theme={null}
    import squarecloud as square

    cliente = square.Client(api_key='CHAVE API')

    async def exemplo():
        app = await cliente.app('id_aplicacao')
        print(app)  # <Application tag='exemplo' id='id_aplicacao'>
    ```
  </Tab>

  <Tab title="Obtendo todas as aplicações">
    ```python theme={null}
    import squarecloud as square

    cliente = square.Client(api_key='CHAVE API')

    async def exemplo():
        apps = await cliente.all_apps()
        print(apps)  # list[<Application tag='exemplo' id='id_aplicacao'>]
    ```
  </Tab>
</Tabs>