API Reference

Complete SDK reference documentation for classes, methods, and type definitions in the HFortix-FortiOS library.

Note

Looking for API endpoints (CMDB, Monitor, Log, Service)? See API Endpoints for the complete endpoint catalog.

SDK Components

Main Client Classes

hfortix_fortios.FortiOS

FortiOS REST API Client

These are the main entry points for interacting with FortiOS devices.

FortiOS - Synchronous client for blocking I/O operations.

AsyncFortiOS - Asynchronous client for concurrent operations with asyncio.

API Handlers

The API handlers provide access to the four main API categories:

  • CMDB Handler - Configuration management (561 endpoints)

  • Monitor Handler - Status and statistics (490 endpoints)

  • Log Handler - Historical data queries (286 endpoints)

  • Service Handler - Operations and actions (11 endpoints)

See API Endpoints for complete endpoint documentation.

Configuration & Authentication

These classes handle client configuration and authentication settings.

Transactions & Batch Operations

hfortix_fortios.Transaction

FortiOS batch transaction manager.

Support for atomic configuration changes and batch operations.

Error Handling

hfortix_fortios.AuthenticationError

HTTP 401 - Authentication failed (invalid credentials)

hfortix_fortios.APIError

Generic API error with optional metadata

Exception classes for handling errors.

Type Definitions

The library includes comprehensive type hints for all endpoints and operations. See the individual endpoint documentation for parameter types and return types.

Advanced Features

Observability & Debugging

The SDK includes built-in observability features:

  • Request/Response Logging

  • Performance Metrics

  • Audit Trail

  • Debug Mode

FortiManager Proxy

The SDK supports managing multiple FortiGates through FortiManager with automatic ADOM and device routing.

Custom Wrappers

You can extend the client classes with your own custom methods and high-level abstractions by subclassing FortiOS or AsyncFortiOS.