API v1 Documentation

import requests
import json
import argparse
import sys

def main():
    # Set up command line argument parsing
    parser = argparse.ArgumentParser(description='imbrr API Client')
    parser.add_argument('--email', required=True, help='Your email address')
    parser.add_argument('--password', required=True, help='Your password')
    parser.add_argument('--id', required=True, help='Device ID (format: AABBCCDDEEFF)')
    parser.add_argument('--base-url', default='https://www.imbrr.com', help='Base URL (default: https://www.imbrr.com)')

    args = parser.parse_args()

    # Configuration
    BASE_URL = args.base_url
    LOGIN_URL = f"{BASE_URL}/login"
    API_BASE = f"{BASE_URL}/api/v1"

    # Create a session to maintain cookies
    session = requests.Session()

    # Login credentials from command line arguments
    login_data = {
        'email': args.email,
        'password': args.password
    }

    # Step 1: Authenticate by logging in
    print("Logging in...")
    login_response = session.post(LOGIN_URL, data=login_data, allow_redirects=True)

    # Check if login was successful (should redirect to dashboard)
    if login_response.status_code == 200 and 'dashboard' in login_response.url:
        print("Login successful! Redirected to dashboard.")

        # Step 2: Get latest depth reading
        device_id = args.id
        depth_url = f"{API_BASE}/latest_depth/{device_id}"

        print(f"Fetching latest depth for device {device_id}...")
        depth_response = session.get(depth_url)

        print(f"Depth response content: {depth_response.text[:500]}...")  # First 500 chars

        if depth_response.status_code == 200:
            try:
                depth_data = depth_response.json()
                print("Latest Depth Reading:")
                print(f"  Depth to water: {depth_data['depth_to_water']}")
                print(f"  Timestamp: {depth_data['timestamp']}")
                print(f"  Flow event status: {depth_data['flow_event_status']}")
                print(f"  Accumulated gallons: {depth_data['accumulated_gallons']}")
            except json.JSONDecodeError as e:
                print(f"Error parsing JSON response: {e}")
                print(f"Raw response: {depth_response.text}")
        else:
            print(f"Error getting depth data: {depth_response.status_code}")
            print(depth_response.text)

        # Step 3: Get latest flow event (CSV download)
        flow_url = f"{API_BASE}/latest_flow_event/{device_id}"

        print(f"Downloading latest flow event for device {device_id}...")
        flow_response = session.get(flow_url)

        print(f"Flow response status: {flow_response.status_code}")

        if flow_response.status_code == 200:
            # Save CSV to file
            filename = f"flow_event_{device_id}.csv"
            with open(filename, 'wb') as f:
                f.write(flow_response.content)
            print(f"Flow event data saved to {filename}")
        else:
            print(f"Error getting flow event data: {flow_response.status_code}")
            print(flow_response.text)

    else:
        print(f"Login failed or unexpected redirect: {login_response.status_code}")
        print(f"Final URL: {login_response.url}")
        print(f"Response content: {login_response.text[:500]}...")
        sys.exit(1)

if __name__ == "__main__":
    main()

python3 api_client.py --email your_email@example.com --password your_password --id AABBCCDDEEFF

import requests
import json
import argparse
import sys

def main():
    # Set up command line argument parsing
    parser = argparse.ArgumentParser(description='imbrr API Client - Cistern Stats')
    parser.add_argument('--email', required=True, help='Your email address')
    parser.add_argument('--password', required=True, help='Your password')
    parser.add_argument('--id', required=True, help='Cistern Device ID (format: AABBCCDDEEFF)')
    parser.add_argument('--base-url', default='https://www.imbrr.com', help='Base URL (default: https://www.imbrr.com)')

    args = parser.parse_args()

    # Configuration
    BASE_URL = args.base_url
    LOGIN_URL = f"{BASE_URL}/login"
    API_BASE = f"{BASE_URL}/api/v1"

    # Create a session to maintain cookies
    session = requests.Session()

    # Login credentials from command line arguments
    login_data = {
        'email': args.email,
        'password': args.password
    }

    # Step 1: Authenticate by logging in
    print("Logging in...")
    login_response = session.post(LOGIN_URL, data=login_data, allow_redirects=True)

    # Check if login was successful (should redirect to dashboard)
    if login_response.status_code == 200 and 'dashboard' in login_response.url:
        print("Login successful! Redirected to dashboard.")

        # Step 2: Get cistern statistics
        device_id = args.id
        cistern_url = f"{API_BASE}/cistern_stats/{device_id}"

        print(f"Fetching cistern statistics for device {device_id}...")
        cistern_response = session.get(cistern_url)

        if cistern_response.status_code == 200:
            try:
                cistern_data = cistern_response.json()
                if cistern_data.get('status') == 'success':
                    print("\nCistern Statistics:")
                    print(f"  Device ID: {cistern_data['id']}")
                    print(f"  Storage: {cistern_data['storage_gallons']:.1f} gallons ({cistern_data['storage_percent']}% full)")
                    print(f"  24 Hour Usage: {cistern_data['24_hour_usage']:.1f} gallons")
                    print(f"  31 Day Usage: {cistern_data['31_day_usage']:.1f} gallons")
                    if cistern_data.get('last_temp'):
                        print(f"  Last Temperature: {cistern_data['last_temp']:.1f}°F")
                    if cistern_data.get('last_pressure'):
                        print(f"  Last Pressure: {cistern_data['last_pressure']:.1f} psi")
                    if cistern_data.get('last_connected'):
                        print(f"  Last Connected: {cistern_data['last_connected']}")
                else:
                    print(f"Error: {cistern_data.get('message', 'Unknown error')}")
            except json.JSONDecodeError as e:
                print(f"Error parsing JSON response: {e}")
                print(f"Raw response: {cistern_response.text}")
        else:
            print(f"Error getting cistern stats: {cistern_response.status_code}")
            try:
                error_data = cistern_response.json()
                print(f"Error message: {error_data.get('message', 'Unknown error')}")
            except:
                print(cistern_response.text)

    else:
        print(f"Login failed or unexpected redirect: {login_response.status_code}")
        print(f"Final URL: {login_response.url}")
        print(f"Response content: {login_response.text[:500]}...")
        sys.exit(1)

if __name__ == "__main__":
    main()

python3 cistern_stats_client.py --email your_email@example.com --password your_password --id AABBCCDDEEFF

# Get latest depth reading
curl -X GET "https://www.imbrr.com/api/v1/latest_depth/AABBCCDDEEFF" \
     -H "Cookie: PHPSESSID=your_session_id" \
     -H "Content-Type: application/json"

# Get cistern statistics (for cistern devices only)
curl -X GET "https://www.imbrr.com/api/v1/cistern_stats/AABBCCDDEEFF" \
     -H "Cookie: PHPSESSID=your_session_id" \
     -H "Content-Type: application/json"