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

# SDK Python

> Consulte a conta e as aplicações com o cliente Python da DSCloud.

O SDK `dscloud-api` exige **Python 3.8+**. Obtenha uma cópia autorizada do código-fonte com a equipe da DS Cloud e instale a partir dessa pasta.

```bash Terminal theme={null}
python -m pip install /caminho/para/DsCloudSDKPY
```

Defina `DSCLOUD_API_KEY` no ambiente. O cliente usa `DSCLOUD_API_BASE_URL` quando configurada e aceita `base_url` como argumento.

```python conta.py theme={null}
import os
from dscloud import Client

client = Client(os.environ["DSCLOUD_API_KEY"])
user = client.get_user()
print(user.name, user.plan.name)

for app in client.get_apps():
    print(app.id, app.name)
```

### Aplicações e arquivos

```python API Python theme={null}
app = client.get_app(os.environ["DSCLOUD_APP_ID"])
status = app.status()
print(status.running, status.ram)

for item in app.files.list("/"):
    print(item.name)
```

Use `client.upload_app("projeto.zip")` para criar uma aplicação ou `app.commit("projeto.zip")` para atualizá-la. O cliente também expõe `app.files.read`, `app.files.write` e `app.files.rename`.

Para consultar a API sem instalar o SDK, use o [exemplo Python da API v3](https://docs.dscloud.pt/api-reference/endpoint/users/me.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.