Introduction
Welcome to the G-Commerce Vendor API — a REST API for managing your vendor store, products, orders, and more.
The G-Commerce API lets your business connect to the G-Commerce marketplace programmatically. Instead of clicking through a dashboard, you can use software to list products, manage orders, and keep your store in sync — all through standard HTTP requests.
What is the Vendor API?
The G-Next Vendor API is organized around REST principles. It uses predictable, resource-oriented URLs, accepts JSON request bodies, returns JSON responses, and uses standard HTTP methods and status codes.
All API requests are versioned under /api/v1/ (and future versions like /api/v2/).
API Endpoints
Use the environment switcher in the documentation header to toggle between environments:
| Environment | Endpoint |
|---|---|
| Production | https://api.next.gcommerce.glass/api/v1 |
| Sandbox | https://sandbox.api.next.gcommerce.glass/api/v1 |
HTTPS required
All production API requests must be made over HTTPS. Calls over plain HTTP will fail.
How requests work
Every API call follows the same pattern:
- Choose an endpoint — e.g.
POST /auth/loginto authenticate. - Add headers — include
Content-Type: application/jsonfor requests with a body, andAuthorization: Bearer <token>for protected endpoints. - Send the request — use cURL, your terminal, or any HTTP client.
- Read the response — JSON body with data or error details.
What's in this documentation?
- Authentication — How to log in and use bearer tokens (start here if you're new).
- Rate limits — Global and login request caps, 429 responses, and retry headers.
- Vendors — Manage your vendor profile and shipping methods.
- Products — Create, update, and bulk-manage your catalog.
- Orders — View and fulfill customer orders.
- Categories — Browse the marketplace taxonomy (read-only; use IDs when assigning products).
- Bulk operations — Bulk update, upload (JSON feed), and export product data at scale.
Need help?
If you're stuck, start with the Quickstart guide or the Authentication overview.