Otevřený standard · Bezplatný software
Open Brand Exchange je otevřený standard pro to, jak si prodejci od značky berou produktové fotografie a data o zboží: v portálu v prohlížeči, jako ZIP nebo tabulku, nebo přímo do svého softwaru přes jedno API. Jak se obsah do vašeho portálu dostane, je na vás.
{
"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
}Jak to funguje
Váš obsah je ve vašem vlastním portálu. Nákupčí v něm hledají a stahují soubory v prohlížeči, jejich software čte stejný obsah přes API.
01 Portál
Nákupčí se přihlásí do vašeho portálu, vloží kódy EAN z objednávky a stáhnou přesně to, co potřebují: jednu fotku, jednu položku nebo ZIP s celým výběrem.
02 API
Software prodejců stáhne vše jednou a pak už jen změny, včetně toho, co stáhnete z nabídky. Každá fotografie přichází s užívacími právy, datem embarga a původem AI.
{
"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 Vaše systémy
Standard řeší, jak si prodejci obsah stahují. Jak se váš obsah dostane do portálu, si zvolíte sami: noční import z webové adresy, SFTP nebo S3, exportní složka nebo nástroj obx pro příkazovou řádku.
$ 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: exportPro koho
Už žádné rozesílání souborů. Prodejci si sami vezmou, co potřebují, a vy rozhodujete, kdo co dostane.
Každá značka v jednom jednotném formátu, v prohlížeči nebo přímo ve vašem softwaru.
Hosting
Tři edice stejného portálu. Procházejí stejnými testy shody a mluví stejným API, takže můžete přejít z jedné na druhou.
Správa
Open Brand Exchange má patřit značkám, prodejcům a dodavatelům softwaru, kteří ho používají, ne jedné firmě.
Verze 0.1, zapsaná jako OpenAPI 3.1 a JSON Schema pod licencí CC-BY-4.0. Implementovat ji smí kdokoli, i komerčně.
61 automatických testů ve čtyřech profilech. Každá implementace se testuje stejně.
SDK, nástroj obx a webové rozhraní jsou pod Apache-2.0. Tři edice portálu jsou pod AGPL-3.0, takže vylepšení zůstávají otevřená.
Autorská práva, název a doména přejdou na Open Brand Exchange Foundation (v založení), jakmile bude zapsána.
Zranitelnosti hlaste důvěrně na [email protected]. Bezpečnost je jedním ze čtyř profilů shody.
Tento web nenastavuje cookies, nepoužívá sledovací nástroje a nic nenačítá z jiných serverů.
Pro vývojáře
Tři kontrakty OpenAPI, JSON Schema, fiktivní testovací značka a sada testů shody. Go SDK a nástroj obx jsou připravené k použití a funguje jakýkoli HTTP klient.
$ 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"]
}Časté dotazy
Standard i software jsou zdarma. Pokud provozujete sami, platíte jen hosting. Poskytovatel má vlastní ceny, které najdete na jeho webu.
Pro základy ne. Portál nainstalujete jedním kliknutím a plánovaný import z webové adresy, serveru SFTP nebo bucketu nevyžaduje žádný kód. Vývojář pomůže, pokud chcete přímo napojit PIM nebo ERP.
Ne. Každá značka provozuje vlastní portál, pokud chce, na vlastní doméně. Neexistuje žádná centrální platforma, která by držela váš obsah.
Vy. Prodejci žádají o přístup a vy každou žádost schválíte nebo zamítnete. Také volíte, jaké značky prodejce uvidí a zda smí stahovat originály.
Spusťte vlastní portál, nebo nám napište o svých systémech a prodejcích a pomozte utvářet první vydání.
Svěřte ho poskytovateli, nebo ho provozujte sami zdarma, jedním kliknutím či jedním příkazem. Možnosti hostingu
Jeden soubor CSV a fotografie s pevným názvem. Váš PIM, ERP nebo obyčejná složka je dodá každou noc, bez ruční práce. Automatizace
Prodejci se přihlásí, vloží seznam EAN a stáhnou si, co potřebují. Jejich systémy získají stejný obsah přes standardní API. Pro prodejce