ovcirrus-api 10.4.3.post3

OmniVista Cirrus RestFul API library for Python

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

    # auth_instance.py
    from api_client.auth import Authenticator
    auth = (
        Authenticator()
        .setURL("https://api.example.com/auth")
        .setCredentials("[e-mail]", "your_password")
        .setApp("your_app_id", "your_app_secret")
        .build()
    )

Step 2: Import the instance and use the apiClient in the .py file

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

    print(userProfile.firstname)

🧪 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

---

📦 Releases

Version	Date	Notes
v10.4.3post2	2025-04-16	Initial release
v10.4.3post3	2025-04-18	Site API, Device API added

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:
[e-mail]