Vendor API
Authenticated REST API for a single vendor — profile, products, orders, shipments, and bulk import.
The Vendor API is for suppliers integrating with Glass Next on behalf of one vendor account. Every endpoint requires authentication. Start at Login — your token and vendor ID are saved automatically and reused across all Try it panels.
Getting started
- Log in —
POST /api/v1/auth/loginwith your vendor user credentials. - Session saved — The docs portal stores your
access_tokenandvendor.idfrom the login response. - Call vendor endpoints — Open any page below and click Send request. Token and
X-Vendor-Idare pre-filled.
Session bar
Check the toolbar at the top right — it shows whether you are authenticated and which vendor is active. Use Clear to reset the session.
Authentication headers
Every vendor endpoint requires:
| Header | Value |
|---|---|
Authorization | Bearer {access_token} from login |
X-Vendor-Id | {vendor.id} from login response |
Vendor roles
| Role | Read | Write (create/update/delete) |
|---|---|---|
| OWNER | Yes | Yes |
| ADMIN | Yes | Yes |
| EDITOR | Yes | Yes |
| VIEWER | Yes | No |
Write operations require OWNER, ADMIN, or EDITOR.
API sections
All paths use the singular /vendor/ prefix and are scoped to your authenticated vendor.
| Section | Base path | Description |
|---|---|---|
| Profile | /vendor/me/* | Profile and logo |
| Shipping Methods | /vendor/me/shipping-methods | Shipping options |
| Products | /vendor/products | Catalog CRUD |
| Bulk Import | /vendor/products/import | Async CSV import |
| Orders | /vendor/orders | Suborder fulfillment |
| Shipments | /vendor/shipments | Tracking and fulfillment |
Base URL: https://api.gcommerce.glass/api/v1 (production) or http://localhost:8080/api/v1 (local).
Live testing
Each endpoint page has a Try it panel. After logging in once, token and vendor ID flow automatically to every vendor endpoint — no need to copy-paste again.