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

> 核心对象是 Client 对象，通过 API 密钥进行实例化。该对象代表与 Square Cloud 服务的连接，并作为与该服务各个方面进行交互的接口。

```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)
```

## 参数：

* api\_key

`api_key: str`：这是实例化 Client 对象时的必需参数。
必须提供一个有效的 API 密钥作为字符串，才能正确执行身份验证。

* debug

`debug: bool = True`：这是一个可选参数，用于控制 Client
对象的调试模式。当设置为 True 时，每次发起请求时，Client 对象都会打印
调试信息，以便于检测和解决
问题。然而，在生产环境中，通常会将该参数设置
为 False，以避免显示不必要的信息。
该值默认为 True。

## Application

使用 \[Client]，你可以获取一个代表你应用的对象（或对象
列表）。该对象是
Application 类的一个实例，你可以用它
更方便地管理你的应用，而无需每次都传递
你应用的 id。

<Tabs>
  <Tab title="获取单个应用">
    ```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="获取所有应用">
    ```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>