Åpen standard · Fri programvare
Open Brand Exchange er en åpen standard for hvordan forhandlere henter produktbilder og varedata fra en merkevare: i en portal i nettleseren, som zip eller regneark, eller rett inn i sin egen programvare via ett API. Hvordan innholdet kommer inn i portalen din, bestemmer du selv.
{
"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
}Slik fungerer det
Innholdet ditt ligger i din egen portal. Innkjøpere søker og laster ned filer i nettleseren, og systemene deres leser det samme innholdet via API-et.
01 Portal
Innkjøpere logger inn på portalen din, limer inn EAN-kodene fra ordren og laster ned akkurat det de trenger: ett bilde, én artikkel eller en zip med et helt utvalg.
02 API
Forhandlernes systemer henter alt én gang og deretter bare det som er endret, også det du trekker tilbake. Hvert bilde kommer med bruksrettigheter, embargodato og KI-opprinnelse.
{
"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 Systemene dine
Standarden handler om hvordan forhandlere henter. Hvordan innholdet ditt kommer inn i portalen, velger du selv: en nattlig import fra en nettadresse, SFTP eller S3, en eksportmappe eller kommandolinjeverktøyet 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: exportHvem det er for
Ikke mer filsending. Forhandlerne henter det de trenger, og du bestemmer hvem som får hva.
Alle merkevarer i ett enhetlig format, i nettleseren eller rett inn i systemet ditt.
Hosting
Tre utgaver av den samme portalen. De består de samme samsvarstestene og snakker det samme API-et, så du kan bytte mellom dem.
Styring
Open Brand Exchange skal tilhøre merkevarene, forhandlerne og programvareleverandørene som bruker den, ikke ett enkelt selskap.
Versjon 0.1, skrevet i OpenAPI 3.1 og JSON Schema under CC-BY-4.0. Alle kan implementere den, også kommersielt.
61 automatiske tester i fire profiler. Alle implementasjoner testes på samme måte.
SDK-et, obx-verktøyet og nettgrensesnittet er Apache-2.0. De tre portalutgavene er AGPL-3.0, så forbedringer forblir åpne.
Opphavsretten, navnet og domenet overføres til Open Brand Exchange Foundation (under stiftelse) når den er registrert.
Rapporter sårbarheter fortrolig til [email protected]. Sikkerhet er én av de fire samsvarsprofilene.
Dette nettstedet setter ingen informasjonskapsler, bruker ingen sporere og laster ingenting fra andre servere.
Utviklere
Tre OpenAPI-kontrakter, JSON Schemas, en fiktiv testmerkevare og samsvarstester. Go SDK og obx-verktøyet er klare til bruk, og enhver HTTP-klient fungerer.
$ 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"]
}Vanlige spørsmål
Standarden og programvaren er gratis. Driver du selv, betaler du bare for hosting. En leverandør har egne priser, som du finner på leverandørens nettsted.
Ikke for det grunnleggende. En portal installeres med ett klikk, og en planlagt import fra en nettadresse, SFTP-server eller bøtte krever ingen kode. En utvikler hjelper hvis du vil koble til PIM eller ERP direkte.
Nei. Hver merkevare driver sin egen portal, på sitt eget domene om den vil. Det finnes ingen sentral plattform som har innholdet ditt.
Det gjør du. Forhandlere ber om tilgang, og du godkjenner eller avslår hver forespørsel. Du velger også hvilke merkevarer en forhandler ser, og om originaler kan lastes ned.
Sett opp din egen portal, eller fortell oss om systemene og forhandlerne dine og vær med på å forme den første utgivelsen.
La en leverandør drive den, eller kjør den selv gratis med ett klikk eller én kommando. Hostingvalg
Én CSV-fil og bilder med fast navn. PIM, ERP eller en vanlig mappe leverer dem hver natt, uten manuelt arbeid. Automatisering
Forhandlere logger inn, limer inn EAN-listen sin og laster ned. Systemene deres henter det samme innholdet via standard-API-et. For forhandlere