1. Authenticate
Generate an API key from the dashboard. Pass it as Authorization: Bearer dsk_live_… on every request. All keys are scoped to read or write and rate-limited atomically server-side.
2. Search the AliExpress catalog
GET /api/v1/products?provider=aliexpress&q=tshirt — results are normalized to a single product schema with BDT prices computed from the latest USD→BDT FX rate and your configured margin.
3. Import a product
POST /api/v1/products/import with the external_id. The product becomes available in your store catalog with stable IDs you can map to Shopify/WooCommerce variants.
4. Place orders with BD addresses
POST /api/v1/orders accepts standard Bangladesh address fields (Dhanmondi, Mirpur, Chattogram) and validates phone numbers in +8801… format. We translate to the supplier's expected schema.
5. Track to the doorstep
We pull tracking from the supplier and hand it off to the BD courier on the last mile. GET /api/v1/orders/{id}/tracking returns a unified event stream — supplier dispatch, customs clear, Pathao pickup, customer signature.