1. Introduction

Welcome, partner. This unified headless commerce API provides direct programmatic access to our product catalog and ordering system. This documentation covers all partner activities including bulk inventory and dropshipping.

API Summary

Authenticate using a bearer token.
Fetch partner products with the `GET /api/partners/products` endpoint.
Create bulk or dropship orders with the `POST /api/partners/orders` endpoint.
Leverage ETag caching to ensure optimal performance.

2. Authentication

Include your secret API key in the `Authorization` header for all requests. The API is rate-limited to 25 requests per minute.

Authorization: Bearer YOUR_SECRET_API_KEY

3. API Endpoints

GET /api/partners/products

Fetches all products available for the partner network. These are items tagged with `wholesale` in our Shopify system.

Caching with ETag:

Store the `ETag` header from your first response.
In subsequent requests, send this value in `If-None-Match`.
A `304 Not Modified` status confirms your local data is current.

POST /api/partners/orders

Creates a draft order. Supports both local inventory stocking and direct-to-consumer dropshipping.

{
    "lineItems": [
        { "variantId": "gid://shopify/ProductVariant/456", "quantity": 1 }
    ],
    "shippingAddress": {
        "firstName": "John",
        "lastName": "Doe",
        "address1": "123 Partner St",
        "city": "Los Angeles",
        "province": "CA",
        "zip": "90001",
        "country": "US"
    }
}

Developer Summary

By unifying our Bulk and Wholesale systems into the Partner network, we provide a single integration point for all B2B activities. Please implement ETag caching to avoid rate limiting and ensure a smooth rollout.