genro-mail-proxy

Asynchronous email dispatcher microservice with scheduling, rate limiting, attachments (S3/URL/base64), Prometheus metrics, and a FastAPI control plane.

• Overview
  • High-level architecture
  • Request flow
  • Client synchronisation
• Architecture Overview
  • Why Use an Email Proxy?
  • Architecture Pattern
  • Key Benefits
  • Comparison Summary
  • When to Use This Architecture
  • Migration Path
  • Conclusion
• Installation
  • Docker
  • Docker Compose
  • Local (Python)
• Usage
  • Configuration
  • Proxy sync exchange
  • Endpoints
  • Test mode
  • REST Examples (curl)
  • Python (httpx)
• Example Client
  • Overview
  • Quick Start
  • Usage Examples
  • Architecture
  • Integration Pattern Explained
  • Code Walkthrough
  • API Reference
  • Testing
  • Troubleshooting
  • Adapting for Your Application
  • See Also
• Protocols and APIs
  • Authentication and base URL
  • REST command surface
  • Message batch payload
  • Delivery report payload
  • Client synchronisation protocol
  • Error handling
• API Reference
  • FastAPI
  • Core endpoints
  • Prometheus metrics
  • Outbound proxy sync
• Python Modules
  • AccountConfigurationError
  • AsyncMailCore
  • AccountInfo
  • AccountPayload
  • AccountsResponse
  • AddMessagesResponse
  • AttachmentPayload
  • BasicOkResponse
  • CleanupMessagesPayload
  • CleanupMessagesResponse
  • CommandStatus
  • DeleteMessagesPayload
  • DeleteMessagesResponse
  • EnqueueMessagesPayload
  • MessagePayload
  • MessageRecord
  • MessagesResponse
  • RejectedMessage
  • create_app()
  • require_token()
  • Persistence
  • SMTPPool
  • RateLimiter
  • Fetcher
  • MailMetrics
  • AttachmentManager
• Contributing