HomeiCloud DocsDocumentation
HomeiCloud B2B developer documentation.
Welcome to the HomeiCloud B2B developer documentation.
Hub Gateway API
The Hub Gateway (/api/hub/*) is the API HomeiCloud B2B exposes to
Homei Hub (the distributor storefront). It lets a distributor browse the B2B
catalog, apply to list products, read live inventory, quote delivery, and place,
track, or cancel dropship orders — without ever learning which fulfillment
provider ships the goods.
Overview
Base URL, conventions, error model, and idempotency.
Authentication
The x-hub-api-key header and per-distributor access control.
Catalog
List and read the publish-gated product catalog.
Orders
Create, track, and cancel dropship orders.
Conventions
- Money is always integer minor units (US cents);
currencyis"USD". - Caching: gateway responses set
cache-control: no-store— always read live, never cache stale price or stock. - Idempotency: orders are idempotent on
reference; applications, withdrawals, and cancellations are safe to retry.
Head to the Hub Gateway API overview to get started.