CycleCore Docs
API publiqueReference APIEndpoints

Lister les produits

GET
/public/v1/products

Retourne les produits lisibles pour l'organisation rattachée à la clé API.

Authorization

BearerAuth
AuthorizationBearer <token>

Utilisez le format : Bearer ccpk_xxxxx

In: header

Query Parameters

page?integer

Page de resultats.

perPage?integer

Nombre maximum d'elements par page.

q?string

Terme de recherche libre.

sort?string

Tri au format champ.ordre, par exemple updatedAt.desc. Plusieurs tris peuvent etre separes par des virgules.

categoryId?string

Filtre les produits par categorie.

channelId?string

Canal a utiliser pour lire les valeurs publiques scopees.

familyId?string

Filtre les produits par famille.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/public/v1/products"
{  "data": [    {      "id": "prod_123",      "identifier": "TSHIRT-BLACK-M",      "label": "T-shirt noir taille M",      "status": "draft",      "family": {        "id": "fam_123",        "label": "Textile"      },      "category": {        "id": "fam_123",        "label": "Textile"      },      "updatedAt": "2026-06-07T12:00:00.000Z"    }  ],  "pagination": {    "page": 1,    "perPage": 10,    "total": 42,    "totalPages": 5,    "hasAny": true  }}
{  "statusCode": 401,  "message": "Clé API invalide.",  "error": "Unauthorized"}
{  "statusCode": 401,  "message": "Clé API invalide.",  "error": "Unauthorized"}
{  "statusCode": 429,  "message": "Limite de requêtes dépassée.",  "error": "Too Many Requests",  "code": "PUBLIC_API_RATE_LIMIT_EXCEEDED",  "retryAfter": 60}