API-HUB is a middleware platform that eliminates the manual work of integrating wholesale promotional product suppliers with OnPrintShop (OPS) storefronts. Instead of building a custom integration per supplier, you configure a single DB row — and the adapter pipeline handles SOAP, REST, pricing, and storefront push automatically.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/VisualGraphxLLC/API-HUB/llms.txt
Use this file to discover all available pages before exploring further.
Quickstart
Get API-HUB running locally with Docker, seed demo data, and trigger your first catalog import.
Architecture
Understand how FastAPI, PostgreSQL, n8n, and the adapter registry fit together.
Adding a Supplier
Connect a new PromoStandards or REST supplier in minutes — no code required.
API Reference
Explore every endpoint: suppliers, catalog, pricing, sync jobs, and OPS push.
How it works
API-HUB sits between your suppliers and your OnPrintShop storefronts, translating supplier-specific protocols (SOAP/REST) into a normalized catalog that drives live pricing and automated storefront push.Add a supplier
Create a supplier row in the UI with its protocol, credentials, and adapter class. The adapter registry handles all SOAP/REST communication — no code deployment needed.
Trigger a catalog import
Call
POST /api/suppliers/{id}/import with a discovery mode (full_sellable, delta, closeouts). API-HUB fetches, normalizes, and stores products and variants.Configure customer markup rules
Set per-customer pricing rules — markup percentage, minimum margin, rounding strategy, and storefront overrides. The pricing engine applies them at quote time.
Key capabilities
994+ Supplier support
PromoStandards Directory auto-discovers all registered suppliers — no hardcoded vendor lists.
Polymorphic catalog
Apparel (tiered variants) and print (formula-based) products share one catalog API.
Live price quotes
Debounced
/api/pricing/quote returns unit price, totals, and a full cost breakdown.Sync health monitoring
Per-supplier health reports: last sync time, recent error count, consecutive failures.
n8n automation
Scheduled cron workflows for catalog, pricing, inventory, and closeout sync.
Encrypted credentials
All supplier and customer credentials are encrypted at rest using Fernet AES-128.