# WispHub API Middleware

## Docs

- [Login — Obtain Access Token](https://docs-wisphub.ainovapro.com/api-reference/auth/login.md): Authenticate with API credentials to receive a JWT Bearer token for subsequent requests
- [Get Client by Document](https://docs-wisphub.ainovapro.com/api-reference/clients/get-by-document.md): Retrieve client information using their identity document (cédula)
- [Get Client by Phone](https://docs-wisphub.ainovapro.com/api-reference/clients/get-by-phone.md): Retrieve client information using their phone number
- [Get Client by Service ID](https://docs-wisphub.ainovapro.com/api-reference/clients/get-by-service-id.md): Retrieve client information using their WispHub service ID
- [List Clients](https://docs-wisphub.ainovapro.com/api-reference/clients/list-clients.md): Retrieve a list of all active clients registered in the system
- [Resolve Client Identity](https://docs-wisphub.ainovapro.com/api-reference/clients/resolve.md): Identify and verify a client in a single call without knowing their service_id
- [Search Clients](https://docs-wisphub.ainovapro.com/api-reference/clients/search.md): Perform a flexible search for clients using a general search term
- [Update Client](https://docs-wisphub.ainovapro.com/api-reference/clients/update.md): Update critical profile data for a client in WispHub
- [Verify Client Identity](https://docs-wisphub.ainovapro.com/api-reference/clients/verify.md): Verify client identity using billing and service information
- [Get Internet Plan Details](https://docs-wisphub.ainovapro.com/api-reference/internet-plans/get-plan.md): Retrieve detailed information about a specific internet plan by ID
- [List Internet Plans](https://docs-wisphub.ainovapro.com/api-reference/internet-plans/list-plans.md): Retrieve all internet plans configured in the WispHub system
- [Create Ping Task](https://docs-wisphub.ainovapro.com/api-reference/network/create-ping.md): Initiate an asynchronous network diagnostic (ICMP PING) task for a client device
- [Get Ping Result](https://docs-wisphub.ainovapro.com/api-reference/network/get-ping-result.md): Retrieve the results of a previously initiated ping diagnostic task
- [API Overview](https://docs-wisphub.ainovapro.com/api-reference/overview.md): Introduction to the WispHub API - base URL, versioning, authentication, and available endpoints
- [Response Structure](https://docs-wisphub.ainovapro.com/api-reference/responses.md): Understanding the BackendResponse format, action types, error handling, and HTTP status codes
- [Check Zone Blocked](https://docs-wisphub.ainovapro.com/api-reference/tickets/check-zone-blocked.md): Verify if a zone has exceeded the maximum ticket limit
- [Create Ticket](https://docs-wisphub.ainovapro.com/api-reference/tickets/create-ticket.md): Create a new technical support ticket in WispHub
- [Get Ticket](https://docs-wisphub.ainovapro.com/api-reference/tickets/get-ticket.md): Retrieve complete information about a technical support ticket
- [List Ticket Subjects](https://docs-wisphub.ainovapro.com/api-reference/tickets/list-subjects.md): Get all valid ticket subjects and priorities available for creating support tickets
- [Architecture](https://docs-wisphub.ainovapro.com/architecture.md): Deep dive into the WispHub API architecture, including FastAPI structure, LRU caching, and middleware design
- [Authentication](https://docs-wisphub.ainovapro.com/authentication.md): WispHub API authentication — JWT Bearer tokens to protect the API and API keys to access WispHub Net
- [Caching System](https://docs-wisphub.ainovapro.com/caching.md): Detailed explanation of the LRU caching implementation using async_lru for optimal performance
- [Docker Deployment](https://docs-wisphub.ainovapro.com/deployment/docker.md): Production-ready Docker deployment guide for the WispHub API with Gunicorn and Uvicorn workers
- [Environment Configuration](https://docs-wisphub.ainovapro.com/deployment/environment.md): Complete guide to configuring environment variables for the WispHub API
- [Local Development Setup](https://docs-wisphub.ainovapro.com/deployment/local-development.md): Set up a local development environment for the WispHub API with Python virtual environment and hot reload
- [Introduction](https://docs-wisphub.ainovapro.com/introduction.md): High-performance RESTful API middleware connecting WispHub Net with third-party applications and conversational interfaces
- [Quickstart](https://docs-wisphub.ainovapro.com/quickstart.md): Get WispHub API up and running in minutes with Docker
- [Load Testing](https://docs-wisphub.ainovapro.com/testing/load-testing.md): Performance and stress testing with Locust to validate concurrency thresholds and caching behavior
- [Testing Overview](https://docs-wisphub.ainovapro.com/testing/overview.md): Comprehensive testing strategy for the WispHub API using pytest, pytest-asyncio, and respx for mocking

## OpenAPI Specs

- [openapi](https://docs-wisphub.ainovapro.com/api-reference/openapi.json)