Standard ouvert · Logiciel libre

Vos contenus produits, prêts pour chaque revendeur.

Open Brand Exchange est un standard ouvert qui définit comment les revendeurs récupèrent les photos produits et les données articles d'une marque : dans un portail depuis leur navigateur, en zip ou en tableur, ou directement dans leur propre logiciel via une API. C'est vous qui choisissez comment les contenus arrivent dans votre portail.

Ouvert
standard, CC-BY-4.0
3
éditions du portail
61
tests de conformité
25
langues
0 €
de licence
Le portail de la marque fictive Kestrel, vu par un revendeur : huit articles, avec des filtres par marque, type de produit et couleur.
GET/obx/v1/changesCe que reçoit le logiciel d'un revendeur
{
  "phase": "live",
  "changes": [
    { "seq": 1042, "op": "delete",
      "type": "asset",
      "external_id": "KO-1001_NVY_2" },
    { "seq": 1043, "op": "upsert",
      "type": "variant",
      "external_id": "2000100101025",
      "data": { "size": "M", … } }
  ],
  "has_more": false
}

Comment ça marche

Une seule source. Les revendeurs récupèrent ce dont ils ont besoin.

Vos contenus se trouvent dans votre propre portail. Les acheteurs y font leurs recherches et téléchargent les fichiers dans leur navigateur ; leurs logiciels lisent les mêmes contenus via l'API.

  1. Vos systèmes

    • PIM
    • ERP
    • DAM
    • Dossier d'export
  2. Alimenter le portail

    • Import planifié
    • Outil obx
    • GitHub Action
    • API d'envoi
  3. Votre portail

    brands.yourbrand.com
    • Catalogue et visuels
    • Accès par revendeur
    • Statistiques d'usage
  4. Vos revendeurs

    Les acheteurs, dans le navigateur

    • Recherche et liste d'EAN
    • Téléchargements zip et CSV

    Leurs logiciels, via l'API

    • Boutique en ligne et PIM
    • Caisse et outils de contenu
Comment le contenu circule des systèmes d'une marque, via son propre portail, jusqu'à ses revendeurs.

01 Portail

Un portail pour les acheteurs de vos revendeurs.

Les acheteurs se connectent à votre portail, collent les EAN de leur commande et téléchargent exactement ce qu'il leur faut : une photo, un article ou le zip de toute une sélection.

  • Recherche et filtres par marque, saison, type de produit et couleur
  • Collez une liste d'EAN et voyez tout de suite ce qui existe et ce qui manque
  • Original, web (2000 px) ou carré, et les données articles en tableur
  • Votre nom, votre logo et votre domaine : « Kestrel · Espace revendeurs »
Voir le portail côté revendeur
Un revendeur colle six EAN dans le portail de la marque : cinq sont trouvés, un est absent du catalogue.

02 API

Une seule API, la même pour chaque marque.

Les logiciels des revendeurs récupèrent tout une fois, puis seulement les changements, y compris ce que vous retirez. Chaque visuel arrive avec ses droits d'utilisation, sa date d'embargo et son origine IA.

  • D'abord une copie complète, ensuite uniquement les changements
  • Recherche par EAN, rattachée au bon article et à la bonne taille
  • Versions web, carrée et miniature ; les originaux si vous l'autorisez
  • Développée une fois par un éditeur, elle fonctionne avec toutes les marques
Lire la référence de l'API
GET/obx/v1/changesAsset
{
  "seq": 1051, "type": "asset", "op": "upsert",
  "external_id": "KO-1003_RST_3",
  "data": {
    "role": "model",
    "color_code": "RST",
    "rights": {
      "license": "retailer-use",
      "channels": ["webshop", "marketplace", "social"],
      "embargo_until": null
    },
    "provenance": { "ai_generated": true, "source": "generated" },
    "renditions": {
      "web":    { "width": 1200, "height": 1500 },
      "square": { "width": 1500, "height": 1500 },
      "thumb":  { "width": 480,  "height": 600 }
    }
  }
}

03 Vos systèmes

Continuez à travailler comme aujourd'hui.

Le standard porte sur la façon dont les revendeurs récupèrent les contenus. Pour alimenter le portail, c'est vous qui choisissez : un import chaque nuit depuis une adresse web, SFTP ou S3, un dossier d'export ou l'outil en ligne de commande obx.

  • Import chaque nuit depuis une adresse web, SFTP ou S3, sans code
  • L'outil obx pour Windows, macOS et Linux n'envoie que ce qui a changé
  • Des recettes pour cron, GitHub Actions, n8n, Make et Zapier
  • Un seul format CSV et une seule règle de nommage des photos
Voir les recettes d'automatisation
Terminal
$ obx push ./export
Publishing to brands.kestrel.example (Kestrel, Kestrel Trail)
images: 27 checked, 3 uploaded (4.2 MB) in 3s
Done: rows: 40, images: 27 → new: 2 · updated: 3 · unchanged: 35
publish.ymlGitHub Action
# .github/workflows/publish.yml
on:
  push:
    paths: ["export/**"]
jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: openbrandexchange/obx-go/push-action@v0
        with:
          url: ${{ secrets.OBX_URL }}
          token: ${{ secrets.OBX_TOKEN }}
          folder: export

Pour qui

Pour les marques et pour les revendeurs.

Pour les marques

Fini les envois de fichiers. Les revendeurs récupèrent ce dont ils ont besoin, et vous décidez qui reçoit quoi.

  • Votre propre portail, sur votre propre domaine
  • Vous validez chaque revendeur et décidez de ce qu'il voit
  • Vous voyez qui télécharge quoi, par revendeur
  • Hébergez-le gratuitement, ou choisissez un prestataire et partez quand vous voulez

Pour les revendeurs

Toutes les marques dans un format unique, dans votre navigateur ou directement dans votre logiciel.

  • Collez votre liste d'EAN et obtenez les bons visuels pour chaque taille
  • Téléchargez zips et données articles, prêts pour votre boutique
  • Une seule connexion pour toutes les marques du standard
  • Droits d'utilisation et dates d'embargo avec chaque visuel

Hébergement

Hébergez-le où vous voulez. Seul l'hébergement se paie.

Trois éditions du même portail. Elles réussissent les mêmes tests de conformité et parlent la même API : vous pouvez passer de l'une à l'autre.

  • En un clic

    Portail pour Cloudflare

    Fonctionne sur
    Cloudflare Workers, avec D1 et R2
    Il vous faut
    Un compte Cloudflare
    Mise en place
    Un clic, puis l'assistant de configuration
    Coût
    Offre Workers Paid, environ 5 dollars par mois
    Installer sur Cloudflare
  • Conteneurs

    Portail pour Google Cloud et Docker

    Fonctionne sur
    Google Cloud Run, ou tout serveur avec Docker
    Il vous faut
    Un compte Google Cloud ou un hôte Docker
    Mise en place
    Un script ou une commande Docker
    Coût
    À l'usage sur Cloud Run, ou votre propre serveur
    Installer avec Docker
  • Sans commande

    Portail pour hébergement web

    Fonctionne sur
    Un hébergement web classique avec PHP et une base de données
    Il vous faut
    Un logiciel FTP
    Mise en place
    Envoyez un zip, puis lancez l'installateur
    Coût
    L'hébergement que vous payez déjà
    Installer sur un hébergement web

Gouvernance

Un standard ouvert, pas une plateforme.

Open Brand Exchange doit appartenir aux marques, aux revendeurs et aux éditeurs de logiciels qui l'utilisent, et non à une seule entreprise.

  • Spécification ouverte

    Version 0.1, rédigée en OpenAPI 3.1 et JSON Schema sous CC-BY-4.0. Chacun peut l'implémenter, y compris à des fins commerciales.

  • Tests de conformité

    61 tests automatisés répartis en quatre profils. Chaque implémentation est testée de la même manière.

  • Licences open source

    Le SDK, l'outil obx et l'interface web sont sous Apache-2.0. Les trois éditions du portail sont sous AGPL-3.0 : les améliorations restent ouvertes.

  • Une fondation en cours de constitution

    Le droit d'auteur, le nom et le domaine seront transférés à l'Open Brand Exchange Foundation (en cours de constitution) dès son enregistrement.

  • Sécurité

    Signalez les vulnérabilités en toute confidentialité à [email protected]. La sécurité est l'un des quatre profils de conformité.

  • Confidentialité d'abord

    Ce site ne dépose aucun cookie, n'utilise aucun traceur et ne charge rien depuis d'autres serveurs.

Découvrir la gouvernance

Développeurs

Une spécification sur laquelle bâtir.

Trois contrats OpenAPI, des schémas JSON, une marque de test fictive et une suite de tests de conformité. Le SDK Go et l'outil obx sont prêts à l'emploi, et n'importe quel client HTTP convient.

Terminal
$ curl https://brands.kestrel.example/.well-known/obx
200 OK · application/json
{
  "obx_version": "0.1",
  "publisher": { "name": "Kestrel Outfitters" },
  "api_base": "https://brands.kestrel.example/obx/v1",
  "portal_url": "https://brands.kestrel.example/",
  "capabilities": ["changes", "products", "by_gtin",
                   "renditions", "exports", "webhooks"]
}

Questions fréquentes

Les premières questions des marques

Toutes les questions
Combien ça coûte ?

Le standard et le logiciel sont gratuits. Si vous hébergez vous-même, vous ne payez que votre hébergement. Un prestataire fixe ses propres tarifs, que vous trouverez sur son site.

Faut-il un développeur ?

Pas pour l'essentiel. Un portail s'installe en un clic, et un import planifié depuis une adresse web, un serveur SFTP ou un bucket ne demande aucun code. Un développeur est utile si vous voulez connecter directement votre PIM ou votre ERP.

Est-ce encore une plateforme à rejoindre ?

Non. Chaque marque fait tourner son propre portail, sur son propre domaine si elle le souhaite. Aucune plateforme centrale ne détient votre contenu.

Qui décide quel revendeur a accès ?

Vous. Les revendeurs demandent l'accès, et vous acceptez ou refusez chaque demande. Vous choisissez aussi quelles marques un revendeur voit et si les originaux peuvent être téléchargés.

Laissez vos revendeurs se servir eux-mêmes.

Mettez en place votre propre portail, ou parlez-nous de vos systèmes et de vos revendeurs pour contribuer à la première version.

  1. Mettez en place votre portail

    Confiez-le à un prestataire, ou hébergez-le vous-même gratuitement en un clic ou une commande. Options d'hébergement

  2. Publiez automatiquement

    Un fichier CSV et des photos nommées selon une règle fixe. Votre PIM, votre ERP ou un simple dossier les livre chaque nuit, sans travail manuel. Automatisation

  3. Vos revendeurs font le reste

    Les revendeurs se connectent, collent leur liste d'EAN et téléchargent. Leurs logiciels récupèrent le même contenu via l'API standard. Pour les revendeurs