Open standaard · Gratis software
Open Brand Exchange is een open standaard voor hoe retailers productfoto's en artikeldata van een merk ophalen: in een portaal in de browser, als zip of spreadsheet, of rechtstreeks in hun eigen software via één API. Hoe de content in je portaal komt, bepaal je zelf.
{
"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
}Zo werkt het
Je content staat in je eigen portaal. Inkopers zoeken en downloaden in de browser; hun software leest dezelfde content via de API.
01 Portaal
Inkopers loggen in op je portaal, plakken de EAN's uit hun order en downloaden precies wat ze nodig hebben: één foto, één artikel of een zip van een hele selectie.
02 API
De software van je retailers haalt alles één keer op en daarna alleen wat veranderde, ook wat je intrekt. Elk beeld komt met zijn gebruiksrechten, embargodatum en AI-herkomst.
{
"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 Je eigen systemen
De standaard gaat over hoe retailers ophalen. Hoe je content in het portaal komt, kies je zelf: een nachtelijke import vanaf een webadres, SFTP of S3, een exportmap, of de obx-tool op de opdrachtregel.
$ 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: exportVoor wie
Geen bestanden meer rondsturen. Retailers halen zelf op wat ze nodig hebben, en jij bepaalt wie wat krijgt.
Elk merk in één vast formaat, in je browser of rechtstreeks in je software.
Hosting
Drie edities van hetzelfde portaal. Ze doorstaan dezelfde conformiteitstests en spreken dezelfde API, dus je kunt van de een naar de ander overstappen.
Governance
Open Brand Exchange hoort toe aan de merken, retailers en softwareleveranciers die het gebruiken, niet aan één bedrijf.
Versie 0.1, vastgelegd als OpenAPI 3.1 en JSON Schema onder CC-BY-4.0. Iedereen mag het implementeren, ook commercieel.
61 geautomatiseerde tests in vier profielen. Elke implementatie wordt op dezelfde manier getest.
De SDK, de obx-tool en de webinterface zijn Apache-2.0. De drie portaaledities zijn AGPL-3.0, zodat verbeteringen open blijven.
Het auteursrecht, de naam en het domein gaan naar de Open Brand Exchange Foundation (in oprichting) zodra die is ingeschreven.
Meld kwetsbaarheden vertrouwelijk aan [email protected]. Beveiliging is een van de vier conformiteitsprofielen.
Deze website plaatst geen cookies, gebruikt geen trackers en laadt niets van andere servers.
Ontwikkelaars
Drie OpenAPI-contracten, JSON Schema's, een fictief testmerk en conformiteitstests. De Go-SDK en de obx-tool zijn klaar voor gebruik, en elke HTTP-client werkt.
$ 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"]
}Veelgestelde vragen
De standaard en de software zijn gratis. Host je zelf, dan betaal je alleen je hosting. Een provider rekent zijn eigen prijzen; die vind je op zijn eigen website.
Niet voor de basis. Een portaal installeer je met één klik, en een geplande import vanaf een webadres, SFTP-server of bucket vraagt geen code. Een ontwikkelaar helpt als je je PIM of ERP direct wilt koppelen.
Nee. Elk merk draait zijn eigen portaal, op zijn eigen domein als het wil. Er is geen centraal platform dat je content beheert.
Jij. Retailers vragen toegang aan en jij keurt elke aanvraag goed of af. Je kiest ook welke merken een retailer ziet en of originelen gedownload mogen worden.
Zet je eigen portaal neer, of vertel ons over je systemen en retailers en denk mee over de eerste release.
Laat een provider het draaien, of host het zelf gratis met één klik of één commando. Hostingopties
Eén CSV-bestand en foto's met een vaste naam. Je PIM, ERP of een gewone map levert ze elke nacht aan, zonder handwerk. Automatiseren
Retailers loggen in, plakken hun EAN-lijst en downloaden. Hun software haalt dezelfde content op via de standaard-API. Voor retailers