python-unifi-client 1.2.0

No project description provided

UniFi API Client Python Port

A Python port of the Art_of_WiFi/Unifi_API_Client library for interacting with Ubiquiti UniFi controllers.
This project preserves the original PHP functionality via Pythons requests and offers:

• cURL_style options mirroring the PHP implementation
• Session management (login/logout)
• Controller_side backup generation & download
• Most REST/stat endpoints translated to Python

Note: User_management methods (create/update/delete) are currently non‑functional due to authorization/404 errors. Contributions welcome!

---

Features

• Login to UniFi OS & classic controllers
• Generate and download network backups
• Mirror PHPs cURL options for timeouts, headers, SSL, etc.
• All major API/stat endpoints converted
• CSRF handling for UniFi OS

---

Dependencies

• http
• sys
• requests
• From requests.exceptions import Timeout, RequestException
• time
• re
• json
• urllib.parse
• http.client
• logging
• base64

Example Usage

from client import Client

# Initialize (disable SSL verify if using self‑signed certs)
client = Client(
    user="admin",
    password="secret",
    baseurl="https://your-controller-ip",
    ssl_verify=False
)

# Login
client.login()

# List sites
sites = client.list_sites()
print(sites)

# Generate & download backup
bak = client.generate_backup(days=0)   # returns [{'url': '/dl/backup/XYZ.unf'}]
content = client.download_backup(bak[0]['url'])
with open("backup.unf", "wb") as f:
    f.write(content)

# Logout
client.logout()

Known Issues

• User management (create/update/delete) as well as some other admin required permissions return 404/unauthorized
• Some endpoints don't get met

License

• Same as the original github
• MIT