Ce que contient le catalogue

Ces chiffres sont lus directement dans la base et se mettent à jour seuls — ce ne sont pas des valeurs saisies dans la page.

430 386: références au total
59 862: dans les collections actuelles
305: marques
82 796: modèles
275 253: références avec photos
324 546: références de lentilles

Le catalogue conserve aussi les modèles arrêtés : ils servent à identifier les stocks et les anciennes collections. Chaque référence porte son propre statut.

Comment récupérer les données

Deux voies selon les équipes : un appel depuis votre système, ou un fichier que n’importe qui peut ouvrir.

API REST

Pour intégrer votre site, votre logiciel de gestion ou vos annonces sur les places de marché.

Filtres par marque, modèle, type, genre, forme, matière et des dizaines d’autres champs
Pagination par curseur : le catalogue entier se récupère sans manque ni doublon
Flux incrémental : vous ne prenez que ce qui a changé depuis la dernière synchronisation

Export Excel

Pour ceux qui veulent un fichier plutôt qu’une intégration. Sans développeur.

Choisissez marques, filtres et colonnes, puis enregistrez la sélection comme modèle
Avant de lancer, vous voyez combien de références entreront dans le fichier
Les gros exports se préparent en arrière-plan ; le lien apparaît dans votre espace

Photographies

Visuels produits sur fond net, prêts pour une vitrine en ligne ou une place de marché.

Dans l’API : liens directs vers les images sur chaque référence
Dans les exports : une archive séparée, classée par marque et modèle
L’archive contient un index reliant chaque code-barres à ses fichiers

À quoi ressemble une réponse

De vraies données du catalogue, pas un exemple tiré de la documentation.

Requête

GET /v1/products?brand=RAY-BAN&has_photo=true&limit=2

Réponse

{
  "data": [
    {
      "ean": "805289003472",
      "brand": "RAY-BAN",
      "model": "RB3136",
      "name": "RB3136 001 58",
      "color": "GOLD",
      "size": "58",
      "gender": "UNISEX",
      "material": "METAL",
      "rrp": 169,
      "currency": "EUR",
      "status": "ACTIVE",
      "images": [
        "https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/805289003472.png"
      ]
    },
    {
      "ean": "8056262017838",
      "brand": "RAY-BAN",
      "model": "RX5425D",
      "name": "RX5425D 2012 54",
      "color": "TORTOISE",
      "size": "54",
      "gender": "UNISEX",
      "material": "ACETATE",
      "rrp": 169,
      "currency": "EUR",
      "status": "ACTIVE",
      "images": [
        "https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8056262017838.jpg"
      ]
    }
  ],
  "meta": {
    "returned": 2,
    "cursor": null
  }
}

Vous choisissez vous-même les champs : si vous ne voulez que le code-barres, le prix et le lien photo, la réponse contiendra exactement cela. La liste complète des champs est fournie par /v1/meta, le point de départ le plus simple pour bâtir l’intégration.

Questions fréquentes

Le catalogue contient-il les stocks ?

Non. Le catalogue est un référentiel : attributs, photos, codes-barres et prix conseillés. La disponibilité vit dans un autre système et ne fait pas partie de ces données. Nous le disons d’emblée pour éviter tout malentendu.

Quels prix fournissez-vous ?

Les prix de vente conseillés, ceux auxquels la marque propose de vendre. Les prix d’achat ne sont transmis ni par l’API ni dans les exports.

Puis-je utiliser les photos sur mon site ?

Oui, c’est la raison la plus fréquente de prendre le catalogue. L’API renvoie des liens directs vers les images ; les exports livrent une archive de fichiers avec un index.

À quelle fréquence les données sont-elles mises à jour ?

Le catalogue s’enrichit en continu, au fur et à mesure des données des marques. L’API dispose d’une méthode qui ne renvoie que les changements depuis une date donnée : inutile de tout retélécharger.

Comment régler ?

Pour l’instant nous émettons une facture : il n’y a pas encore de paiement par carte sur le site. Quand il existera, les clients en cours n’auront rien à changer.

Les lentilles de contact sont-elles incluses ?

Oui, dans une section dédiée : rayon, puissance, cylindre, axe, addition, conditionnement et prix. Il n’y a pas de photos de lentilles en base : elles apporteraient peu.