Total Apex APItotalapex.com ↗

"""
Total Apex Document Library API Client
Get your API key from: https://parse.bot/settings
"""

import os
import requests
from typing import Optional, Dict, Any


class ParseClient:
    """Client for the Total Apex Document Library API."""
    
    def __init__(self, api_key: Optional[str] = None):
        """Initialize the Parse API client.
        
        Args:
            api_key: API key for authentication. If not provided, reads from PARSE_API_KEY env var.
        """
        self.base_url = "https://api.parse.bot"
        self.scraper_id = "fe8b4be0-09b9-4a8f-b116-b1120c5ce6d5"
        self.api_key = api_key or os.getenv("PARSE_API_KEY")
        
        if not self.api_key:
            raise ValueError("API key must be provided or set in PARSE_API_KEY environment variable")
    
    def _call(self, endpoint: str, method: str = "POST", **params) -> Dict[str, Any]:
        """Make an API call to the Parse Bot API.
        
        Args:
            endpoint: The API endpoint name
            method: HTTP method (GET or POST)
            **params: Query/body parameters
            
        Returns:
            Response JSON as dictionary
        """
        url = f"{self.base_url}/scraper/{self.scraper_id}/{endpoint}"
        headers = {
            "X-API-Key": self.api_key,
            "Content-Type": "application/json"
        }
        
        if method == "GET":
            response = requests.get(url, headers=headers, params=params)
        elif method == "POST":
            response = requests.post(url, headers=headers, json=params)
        else:
            raise ValueError(f"Unsupported HTTP method: {method}")
        
        response.raise_for_status()
        return response.json()
    
    def list_documents(
        self,
        page: int = 1,
        keyword: Optional[str] = None,
        manufacturer: Optional[str] = None,
        equipment_type: Optional[str] = None,
        document_type: Optional[str] = None,
        limit: int = 20
    ) -> Dict[str, Any]:
        """List documents from the Total Apex Document Library.
        
        Args:
            page: Page number for pagination (1-indexed)
            keyword: Search keyword to filter documents
            manufacturer: Filter by manufacturer name
            equipment_type: Filter by equipment type
            document_type: Filter by document type
            limit: Number of results per page
            
        Returns:
            Dictionary containing documents list and pagination info
        """
        params = {
            "page": page,
            "limit": limit
        }
        
        if keyword:
            params["keyword"] = keyword
        if manufacturer:
            params["manufacturer"] = manufacturer
        if equipment_type:
            params["equipment_type"] = equipment_type
        if document_type:
            params["document_type"] = document_type
        
        return self._call("list_documents", method="GET", **params)


def main():
    """Practical workflow example for the Total Apex Document Library API."""
    
    # Initialize the client
    client = ParseClient()
    
    print("=" * 80)
    print("Total Apex Document Library - Practical Usage Example")
    print("=" * 80)
    
    # Workflow 1: Search for Ice-O-Matic ice machine manuals
    print("\n[WORKFLOW 1] Searching for Ice-O-Matic ice machine manuals...")
    print("-" * 80)
    
    results = client.list_documents(
        manufacturer="Ice-O-Matic",
        equipment_type="Ice Products",
        document_type="Manuals",
        limit=5
    )
    
    print(f"Found {results['total_items']} total documents matching criteria")
    print(f"Showing {results['items_on_page']} documents from page {results['page']} of {results['total_pages']}")
    print()
    
    # Process and display the documents
    for idx, doc in enumerate(results['documents'], 1):
        print(f"Document {idx}:")
        print(f"  Name: {doc['document_name']}")
        print(f"  Model: {doc.get('model', 'N/A')}")
        print(f"  Manufacturer: {doc.get('manufacturer', 'N/A')}")
        print(f"  Equipment Type: {doc.get('equipment_type', 'N/A')}")
        print(f"  PDF URL: {doc['pdf_url'][:60]}...")
        print()
    
    # Workflow 2: Search by keyword for beverage equipment
    print("\n[WORKFLOW 2] Searching for beverage dispensers specifications...")
    print("-" * 80)
    
    results = client.list_documents(
        keyword="dispenser",
        equipment_type="Beverage Equipment",
        document_type="Specifications",
        limit=3
    )
    
    print(f"Found {results['total_items']} documents with keyword 'dispenser'")
    print(f"Showing {results['items_on_page']} documents\n")
    
    for idx, doc in enumerate(results['documents'], 1):
        print(f"Specification Document {idx}:")
        print(f"  Name: {doc['document_name']}")
        print(f"  Model: {doc.get('model', 'N/A')}")
        print(f"  Manufacturer: {doc.get('manufacturer', 'N/A')}")
        print()
    
    # Workflow 3: Collect documents from multiple pages for a specific manufacturer
    print("\n[WORKFLOW 3] Collecting Lancer beverage equipment across pages...")
    print("-" * 80)
    
    all_documents = []
    pages_to_check = 2
    
    for page_num in range(1, pages_to_check + 1):
        print(f"Fetching page {page_num}...")
        results = client.list_documents(
            manufacturer="Lancer",
            equipment_type="Beverage Equipment",
            page=page_num,
            limit=10
        )
        
        all_documents.extend(results['documents'])
        print(f"  Retrieved {results['items_on_page']} documents")
        
        if page_num >= results['total_pages']:
            print(f"Reached end of results (page {results['total_pages']})")
            break
    
    print(f"\nTotal documents collected: {len(all_documents)}")
    print("Documents by type:")
    equipment_types = {}
    for doc in all_documents:
        eq_type = doc.get('equipment_type', 'Unknown')
        equipment_types[eq_type] = equipment_types.get(eq_type, 0) + 1
    
    for eq_type, count in equipment_types.items():
        print(f"  {eq_type}: {count}")
    
    # Workflow 4: Search for refrigeration equipment parts lists
    print("\n[WORKFLOW 4] Searching for refrigeration equipment parts lists...")
    print("-" * 80)
    
    results = client.list_documents(
        equipment_type="Refrigeration Equipment",
        document_type="Parts List",
        limit=5
    )
    
    print(f"Found {results['total_items']} parts list documents")
    print(f"Total pages available: {results['total_pages']}")
    
    if results['documents']:
        print("\nSample documents:")
        manufacturers = set()
        for doc in results['documents'][:3]:
            manufacturer = doc.get('manufacturer', 'Unknown')
            manufacturers.add(manufacturer)
            print(f"  - {doc['document_name']} ({doc.get('model', 'N/A')})")
        
        print(f"\nManufacturers represented: {', '.join(sorted(manufacturers))}")
    
    print("\n" + "=" * 80)
    print("Workflow demonstration complete!")
    print("=" * 80)


if __name__ == "__main__":
    main()