Recommended settings:
- Always set a descriptive User-Agent (don't use blank/default)
- Use streaming downloads
- Use longer timeouts for large files (e.g., 300s)

Good example User-Agent:
DNFileVaultClient/1.0 ([email protected])

Python requests example:

import os
import requests

BASE_URL = "https://api.dnfilevault.com"

email = os.environ["DNFILEVAULT_EMAIL"]
password = os.environ["DNFILEVAULT_PASSWORD"]

headers = {
    "User-Agent": "DNFileVaultClient/1.0 ([email protected])"
}

login = requests.post(
    f"{BASE_URL}/auth/login",
    json={"email": email, "password": password},
    headers=headers,
    timeout=60,
)
login.raise_for_status()
token = login.json()["token"]

headers["Authorization"] = f"Bearer {token}"

files = requests.get(
    f"{BASE_URL}/groups/2/files",
    headers=headers,
    timeout=60,
).json()

# Large downloads: stream + longer timeout
resp = requests.get(
    f"{BASE_URL}/download/<uuid_filename>",
    headers=headers,
    stream=True,
    timeout=300,
)
try:
    resp.raise_for_status()
    with open("download.zip", "wb") as f:
        for chunk in resp.iter_content(chunk_size=1024 * 1024):
            if chunk:
                f.write(chunk)
finally:
    resp.close()