Demarrage rapide

L'API publique se consomme avec une cle API generee depuis les reglages d'une organisation CycleCore. La cle identifie l'organisation et porte les scopes autorises.

1. Creer une cle API

Depuis CycleCore:

1. Ouvrez l'organisation cible.
2. Allez dans les reglages de l'organisation.
3. Ouvrez la section "Cles API".
4. Creez une cle et selectionnez les scopes necessaires.
5. Copiez la cle immediatement. Elle n'est affichee qu'une seule fois.

2. Faire un appel de test

curl https://api.cyclecoreapp.com/public/v1/products \
  -H "Authorization: Bearer ccpk_xxx"

Une reponse valide retourne les produits visibles pour l'organisation associee a la cle.

[
  {
    "id": "prod_123",
    "identifier": "TSHIRT-BLACK-M",
    "label": "T-shirt noir taille M",
    "status": "draft",
    "family": {
      "id": "fam_123",
      "label": "Textile"
    },
    "category": {
      "id": "cat_123",
      "label": "T-shirts"
    },
    "updatedAt": "2026-06-07T12:00:00.000Z"
  }
]

3. Ajouter les scopes utiles

Les scopes disponibles en V1 sont:

Si un appel retourne 403, la cle est valide mais le scope requis manque.

4. Integrer progressivement

Pour une premiere integration, synchronisez les referentiels dans cet ordre:

1. Familles.
2. Attributs.
3. Categories.
4. Medias.
5. Produits.

Cette approche permet de reconstruire le contexte metier avant de consommer les produits eux-memes.