Öppen standard · Fri programvara
Open Brand Exchange är en öppen standard för hur återförsäljare hämtar produktbilder och artikeldata från ett varumärke: i en portal i webbläsaren, som zip eller kalkylblad, eller direkt in i sitt eget system via ett API. Hur innehållet kommer in i din portal bestämmer du själv.
{
"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
}Så fungerar det
Ditt innehåll finns i din egen portal. Inköpare söker och laddar ner filer i webbläsaren, och deras system läser samma innehåll via API:et.
01 Portal
Inköpare loggar in i din portal, klistrar in EAN-koderna från sin order och laddar ner exakt det de behöver: en bild, en artikel eller en zip med ett helt urval.
02 API
Återförsäljarnas system hämtar allt en gång och sedan bara det som ändrats, även det du drar tillbaka. Varje bild kommer med användningsrättigheter, embargodatum och AI-ursprung.
{
"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 Dina system
Standarden handlar om hur återförsäljare hämtar. Hur ditt innehåll kommer in i portalen väljer du själv: en nattlig import från en webbadress, SFTP eller S3, en exportmapp eller kommandoradsverktyget 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: exportVem det är för
Inga fler filer att skicka runt. Återförsäljarna hämtar det de behöver, och du bestämmer vem som får vad.
Alla varumärken i ett enhetligt format, i webbläsaren eller direkt i ditt system.
Hosting
Tre utgåvor av samma portal. De klarar samma konformitetstester och talar samma API, så du kan byta mellan dem.
Styrning
Open Brand Exchange ska tillhöra de varumärken, återförsäljare och programvaruleverantörer som använder den, inte ett enskilt företag.
Version 0.1, skriven i OpenAPI 3.1 och JSON Schema under CC-BY-4.0. Alla får implementera den, även kommersiellt.
61 automatiska tester i fyra profiler. Alla implementationer testas på samma sätt.
SDK:t, verktyget obx och webbgränssnittet är Apache-2.0. De tre portalutgåvorna är AGPL-3.0, så förbättringar förblir öppna.
Upphovsrätten, namnet och domänen går över till Open Brand Exchange Foundation (under bildande) när den är registrerad.
Rapportera sårbarheter konfidentiellt till [email protected]. Säkerhet är en av de fyra konformitetsprofilerna.
Den här webbplatsen sätter inga kakor, använder inga spårare och laddar inget från andra servrar.
Utvecklare
Tre OpenAPI-kontrakt, JSON Schemas, ett fiktivt testvarumärke och konformitetstester. Go SDK och verktyget obx är redo att användas, och alla HTTP-klienter fungerar.
$ 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"]
}Vanliga frågor
Standarden och programvaran är gratis. Kör du själv betalar du bara för hosting. En leverantör har egna priser som du hittar på leverantörens webbplats.
Inte för grunderna. En portal installeras med ett klick, och en schemalagd import från en webbadress, SFTP-server eller bucket kräver ingen kod. En utvecklare hjälper om du vill koppla ditt PIM eller ERP direkt.
Nej. Varje varumärke kör sin egen portal, på sin egen domän om det vill. Det finns ingen central plattform som håller ditt innehåll.
Du. Återförsäljare ansöker om åtkomst och du godkänner eller avslår varje ansökan. Du väljer också vilka varumärken en återförsäljare ser och om original får laddas ner.
Sätt upp din egen portal, eller berätta om dina system och återförsäljare och var med och forma den första versionen.
Låt en leverantör sköta den, eller kör den själv gratis med ett klick eller ett kommando. Hostingalternativ
En CSV-fil och bilder med ett fast namn. Ditt PIM, ERP eller en vanlig mapp levererar dem varje natt, helt utan handpåläggning. Automatisering
Återförsäljare loggar in, klistrar in sin EAN-lista och laddar ner. Deras system hämtar samma innehåll via standard-API:et. För återförsäljare