OmniVista Cirrus API Library for Python - OVCirrusApi

OVCirrusApi is a lightweight python library that enables developers to interact seamlessly with the OmniVista Cirrus RESTful API.

✨ Supported APIs

The full API documentation is available at: OmniVista Cirrus API Docs

• Authentication API
• User API
• Organization API
• Site API
• Device API

🛠️ Built With

• python 3.8

    dependencies = [
        "httpx>=0.24.1",
        "requests>=2.31.0",
        "pydantic>=2.0",
        "pybreaker>=0.7.0",
        "backoff>=2.2.1"
    ]

🚀 Installation

1. pip install ovcirrus-api

📦 Usage Guide

Step 1: Create a global instance of Authenticator object in auth_instance.py

    # auth_instance.py
    from aos8_api.api_client import Authenticator
    auth = (
        Authenticator()
        .setURL("https://api.example.com/auth")
        .setCredentials("your@email.com", "your_password")
        .setApp("your_app_id", "your_app_secret")
        .build()
    )

Step 2: Import the auth instance and apiClient library in your .py application

    from auth_instance import auth  # auth_instance.py
    from api_client import OVCirrusApiClient
    
    apiClient = OVCirrusApiClient(base_url=API_BASE_URL, auth=auth)
    userProfile = await apiClient.user.getUserProfile()
    if userProfile is None:
        print("Failed to retrieve profile.")
        return
    else:
        print(userProfile.firstname)

    await apiClient.close()

🧪 Give it a try - example_usage.py

1. Fill in the API credentials in the .env file

API_BASE_URL = "https://<base_url>/"
AUTH_URL = API_BASE_URL + "api/ov/v1/applications/authenticate"

EMAIL = "<email>"
PASSWORD = "<password>"
APP_ID = "<appId>"
APP_SECRET = "<appSecret>"

2. Run the script, python .\example_usage.py

📚 Available Methods

User API:

• getUserProfile
• UpdateUserProfile

Organization API:

• createAnOrganization
• getAllUserOrganizations
• getOrganizationBasicSettings
• getOrganization
• updateOrganization
• deleteOrganization

Site API

• createSite
• getOrganizationSites
• getOrganizationSitesBuildingsFloors
• getSite
• updateSite
• deleteSite

Device API

• createDevice
• getAllDevices
• createRemoteAP
• getAllDevicesFromOrganization
• getDevice
• getDeviceDetails
• updateDevice
• deleteDevice
• updateRemoteAP
• saveToRunning
• reboot

SSID API

• getAllSsids
• createSSID

📦 Releases

Visit the Releases page to download .zip packages.

📄 License

Copyright (c) Samuel Yip Kah Yean <2025>

This software is licensed for personal, non-commercial use only.

You are NOT permitted to:
- Use this software for any commercial purposes.
- Modify, adapt, reverse-engineer, or create derivative works.
- Distribute, sublicense, or share this software.

All rights are reserved by the author.

For commercial licensing or permission inquiries, please contact:
kahyean.yip@gmail.com