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

# Client

> L'oggetto centrale è l'oggetto Client, istanziato con una chiave API. Questo oggetto rappresenta una connessione al servizio Square Cloud e funge da interfaccia per interagire con vari aspetti del servizio.

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

client = square.Client(api_key='API_KEY')

async def example():
    app_status = await client.app_status('application_id')
    print(app_status)
```

## Parametri:

* api\_key

`api_key: str`: Questo è il parametro obbligatorio quando si istanzia l'oggetto Client.
Una chiave API valida deve essere fornita come stringa affinché l'autenticazione venga eseguita correttamente.

* debug

`debug: bool = True`: Questo è un parametro opzionale che controlla la modalità di debug
dell'oggetto Client. Quando è impostato su True, ogni volta che viene effettuata una richiesta, l'oggetto Client stampa
informazioni di debug per facilitare l'individuazione e la risoluzione dei
problemi. Tuttavia, negli ambienti di produzione, è comune impostare questo parametro
su False per evitare di visualizzare informazioni non necessarie.
Questo valore ha come predefinito True.

## Application

Usando il \[Client], puoi ottenere un oggetto (o una lista di
oggetti) che rappresenta la tua applicazione. Questo oggetto sarebbe un'istanza della
classe Application che puoi usare
per gestire la tua applicazione più comodamente, senza dover sempre passare
l'id della tua applicazione.

<Tabs>
  <Tab title="ottenere un'applicazione">
    ```python theme={null}
    import squarecloud as square

    client = square.Client(api_key='API KEY')

    async def example():
        app = await client.app('application id')
        print(app)  # <Application tag='example' id='application_id'>
    ```
  </Tab>

  <Tab title="ottenere tutte le applicazioni">
    ```python theme={null}
    import squarecloud as square

    client = square.Client(api_key='API KEY')

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