Offener Standard · Freie Software
Open Brand Exchange ist ein offener Standard dafür, wie Händler Produktfotos und Artikeldaten von einer Marke abrufen: in einem Portal im Browser, als ZIP oder Tabelle oder über eine API direkt in ihre eigene Software. Wie die Inhalte in Ihr Portal kommen, entscheiden Sie selbst.
{
"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
}So funktioniert es
Ihre Inhalte liegen in Ihrem eigenen Portal. Einkäufer suchen dort und laden Dateien im Browser herunter; ihre Software liest dieselben Inhalte über die API.
01 Portal
Einkäufer melden sich in Ihrem Portal an, fügen die EANs aus ihrer Bestellung ein und laden genau das herunter, was sie brauchen: ein Foto, einen Artikel oder eine ganze Auswahl als ZIP.
02 API
Die Software der Händler holt einmal alles und danach nur noch die Änderungen, auch das, was Sie zurückziehen. Jedes Bild kommt mit Nutzungsrechten, Sperrfrist und KI-Herkunft.
{
"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 Ihre Systeme
Der Standard regelt, wie Händler Inhalte abrufen. Wie Ihre Inhalte ins Portal kommen, entscheiden Sie: ein nächtlicher Import von einer Webadresse, per SFTP oder aus S3, ein Exportordner oder das Kommandozeilen-Tool obx.
$ 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# .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: exportFür wen
Kein Hin- und Herschicken von Dateien mehr. Händler holen sich, was sie brauchen, und Sie entscheiden, wer was bekommt.
Jede Marke im selben Format, im Browser oder direkt in Ihrer Software.
Hosting
Drei Editionen desselben Portals. Sie bestehen dieselben Konformitätstests und sprechen dieselbe API, ein Wechsel ist also jederzeit möglich.
Governance
Open Brand Exchange soll den Marken, Händlern und Softwareanbietern gehören, die es nutzen, und nicht einem einzelnen Unternehmen.
Version 0.1, beschrieben in OpenAPI 3.1 und JSON Schema unter CC-BY-4.0. Jeder darf sie implementieren, auch kommerziell.
61 automatisierte Tests in vier Profilen. Jede Implementierung wird auf dieselbe Weise geprüft.
SDK, obx-Tool und Weboberfläche stehen unter Apache-2.0. Die drei Portal-Editionen unter AGPL-3.0, damit Verbesserungen offen bleiben.
Urheberrecht, Name und Domain gehen an die Open Brand Exchange Foundation (in Gründung), sobald sie eingetragen ist.
Melden Sie Schwachstellen vertraulich an [email protected]. Sicherheit ist eines der vier Konformitätsprofile.
Diese Website setzt keine Cookies, nutzt keine Tracker und lädt nichts von fremden Servern.
Entwickler
Drei OpenAPI-Verträge, JSON-Schemas, eine fiktive Testmarke und Konformitätstests. Go-SDK und obx-Tool sind sofort einsatzbereit, und jeder HTTP-Client funktioniert.
$ curl https://brands.kestrel.example/.well-known/obx{
"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"]
}Häufige Fragen
Standard und Software sind kostenlos. Wenn Sie selbst hosten, zahlen Sie nur Ihr Hosting. Ein Anbieter hat eigene Preise, die Sie auf seiner Website finden.
Nicht für die Grundlagen. Ein Portal installieren Sie mit einem Klick, und ein geplanter Import von einer Webadresse, einem SFTP-Server oder Bucket braucht keinen Code. Ein Entwickler hilft, wenn Sie Ihr PIM oder ERP direkt anbinden möchten.
Nein. Jede Marke betreibt ihr eigenes Portal, auf Wunsch unter eigener Domain. Es gibt keine zentrale Plattform, die Ihre Inhalte hält.
Sie. Händler beantragen Zugang, und Sie genehmigen oder lehnen jede Anfrage ab. Sie wählen auch, welche Marken ein Händler sieht und ob Originale heruntergeladen werden dürfen.
Richten Sie Ihr eigenes Portal ein, oder erzählen Sie uns von Ihren Systemen und Händlern und gestalten Sie die erste Version mit.
Lassen Sie es von einem Anbieter betreiben, oder hosten Sie es kostenlos selbst, mit einem Klick oder einem Befehl. Hosting-Optionen
Eine CSV-Datei und Fotos mit festem Namen. Ihr PIM, ERP oder ein einfacher Ordner liefert sie jede Nacht, ganz ohne Handarbeit. Automatisierung
Händler melden sich an, fügen ihre EAN-Liste ein und laden herunter. Ihre Software holt dieselben Inhalte über die Standard-API. Für Händler