Otvorený štandard · Bezplatný softvér
Open Brand Exchange je otvorený štandard pre to, ako predajcovia získavajú od značky produktové fotografie a údaje o tovare: na portáli v prehliadači, ako ZIP alebo tabuľku, alebo priamo vo vlastnom softvéri cez jedno API. Ako sa obsah dostane do vášho portálu, 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
}Ako to funguje
Váš obsah je vo vašom vlastnom portáli. Nákupcovia v ňom vyhľadávajú a sťahujú súbory v prehliadači, ich softvér číta rovnaký obsah cez API.
01 Portál
Nákupcovia sa prihlásia do vášho portálu, vložia kódy EAN z objednávky a stiahnu presne to, čo potrebujú: jednu fotku, jednu položku alebo ZIP s celým výberom.
02 API
Softvér predajcov stiahne všetko raz a potom už len zmeny, vrátane toho, čo stiahnete z ponuky. Každá fotografia prichádza s právami na použitie, dátumom embarga a pôvodom 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
Štandard sa týka toho, ako si predajcovia obsah sťahujú. Ako sa váš obsah dostane do portálu, si vyberiete sami: nočný import z webovej adresy, SFTP alebo S3, exportný priečinok alebo nástroj obx pre príkazový riadok.
$ 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: exportPre koho
Už žiadne rozosielanie súborov. Predajcovia si vezmú, čo potrebujú, a vy rozhodujete, kto čo dostane.
Každá značka v jednom jednotnom formáte, v prehliadači alebo priamo vo vašom softvéri.
Hosting
Tri edície toho istého portálu. Prechádzajú rovnakými testami zhody a hovoria rovnakým API, takže môžete prejsť z jednej na druhú.
Správa
Open Brand Exchange má patriť značkám, predajcom a dodávateľom softvéru, ktorí ho používajú, nie jednej firme.
Verzia 0.1, zapísaná ako OpenAPI 3.1 a JSON Schema pod licenciou CC-BY-4.0. Implementovať ju smie ktokoľvek, aj komerčne.
61 automatických testov v štyroch profiloch. Každá implementácia sa testuje rovnako.
SDK, nástroj obx a webové rozhranie sú pod Apache-2.0. Tri edície portálu sú pod AGPL-3.0, takže vylepšenia zostávajú otvorené.
Autorské práva, názov a doména prejdú na Open Brand Exchange Foundation (v založení), hneď ako bude zaregistrovaná.
Zraniteľnosti hláste dôverne na [email protected]. Bezpečnosť je jedným zo štyroch profilov zhody.
Tento web nenastavuje cookies, nepoužíva sledovacie nástroje a nič nenačítava z iných serverov.
Pre vývojárov
Tri kontrakty OpenAPI, JSON Schema, fiktívna testovacia značka a sada testov zhody. Go SDK a nástroj obx sú pripravené na použitie a funguje akýkoľvek 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é otázky
Štandard aj softvér sú zadarmo. Ak prevádzkujete sami, platíte iba hosting. Poskytovateľ má vlastné ceny, ktoré nájdete na jeho webe.
Na základy nie. Portál nainštalujete jedným kliknutím a plánovaný import z webovej adresy, servera SFTP alebo bucketu nevyžaduje žiadny kód. Vývojár pomôže, ak chcete priamo napojiť PIM alebo ERP.
Nie. Každá značka prevádzkuje vlastný portál, ak chce, na vlastnej doméne. Neexistuje žiadna centrálna platforma, ktorá by držala váš obsah.
Vy. Predajcovia žiadajú o prístup a vy každú žiadosť schválite alebo zamietnete. Tiež volíte, aké značky predajca uvidí a či smie sťahovať originály.
Spustite vlastný portál alebo nám napíšte o svojich systémoch a predajcoch a pomôžte formovať prvé vydanie.
Zverte ho poskytovateľovi alebo ho prevádzkujte sami zadarmo, jedným kliknutím či jedným príkazom. Možnosti hostingu
Jeden súbor CSV a fotografie s pevným názvom. Váš PIM, ERP alebo obyčajný priečinok ich dodá každú noc, bez ručnej práce. Automatizácia
Predajcovia sa prihlásia, vložia zoznam EAN a stiahnu si, čo potrebujú. Ich systémy získajú rovnaký obsah cez štandardné API. Pre predajcov