Developer docs
Which API?
New: Application API docs
Pick the API you are reading here — the Merchant API for your own store, the Application API for partner apps.
Developer docs
New: Application API docs
Pick the API you are reading here — the Merchant API for your own store, the Application API for partner apps.
Everything you need to integrate with the Gini v2 Third-Party API.
Create and manage product collections — curated groups of your products with a cover image, matching the dashboard's Collections screen.
Your collections, newest first. Returns name, description, slug, is_main, image, and the member products. Paginated.
/api/v2.0/third-party/collections
A single record by its numeric id. 404 if it is not yours.
/api/v2.0/third-party/collections/{collection}
/api/v2.0/third-party/collections
| Field | Type | Required | Description |
|---|---|---|---|
name
|
string | Required | 3–255 chars, unique among your collections. |
description
|
string | Required | 3–1000 chars. |
image
|
file | Required | Cover image (jpg/png/webp, max 5 MB). Multipart. |
product_ids[]
|
integer[] | Required | Products to include (at least 1). Each must be yours. |
is_main
|
boolean | Optional | Mark as a main collection. |
Partial — send only the fields you are changing. 404 if it is not yours.
/api/v2.0/third-party/collections/{collection}
/api/v2.0/third-party/collections/{collection}