Odprt standard · Brezplačna programska oprema
Open Brand Exchange je odprt standard za to, kako trgovci od znamke dobijo fotografije izdelkov in podatke o artiklih: na portalu v brskalniku, kot zip ali preglednico ali neposredno v svojo programsko opremo prek enega API-ja. Kako vsebina pride v vaš portal, se odločite sami.
{
"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
}Kako deluje
Vaša vsebina je v vašem lastnem portalu. Nabavniki v brskalniku iščejo in prenašajo datoteke, njihova programska oprema pa isto vsebino bere prek API-ja.
01 Portal
Nabavniki se prijavijo v vaš portal, prilepijo kode EAN iz naročila in prenesejo natanko to, kar potrebujejo: eno fotografijo, en artikel ali ZIP celotnega izbora.
02 API
Programska oprema trgovcev vse prenese enkrat, nato pa le spremembe, tudi to, kar umaknete. Vsaka fotografija pride s pravicami uporabe, datumom embarga in podatkom o izvoru umetne inteligence.
{
"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ši sistemi
Standard določa, kako trgovci vsebino prevzamejo. Kako vaša vsebina pride v portal, izberete sami: nočni uvoz s spletnega naslova, SFTP ali S3, izvozna mapa ali orodje obx v ukazni vrstici.
$ 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: exportZa koga
Nič več pošiljanja datotek. Trgovci vzamejo, kar potrebujejo, vi pa odločate, kdo dobi kaj.
Vsaka znamka v enem doslednem formatu, v brskalniku ali neposredno v vaši programski opremi.
Gostovanje
Tri izdaje istega portala. Prestanejo ista preverjanja skladnosti in govorijo isti API, zato lahko prehajate med njimi.
Upravljanje
Open Brand Exchange naj pripada znamkam, trgovcem in ponudnikom programske opreme, ki ga uporabljajo, ne enemu podjetju.
Različica 0.1, zapisana kot OpenAPI 3.1 in JSON Schema pod licenco CC-BY-4.0. Implementira jo lahko vsakdo, tudi komercialno.
61 samodejnih preverjanj v štirih profilih. Vsaka implementacija je preizkušena na enak način.
SDK, orodje obx in spletni vmesnik so pod Apache-2.0. Tri izdaje portala so pod AGPL-3.0, zato izboljšave ostanejo odprte.
Avtorske pravice, ime in domena bodo prešli na Open Brand Exchange Foundation (v ustanavljanju), takoj ko bo registrirana.
Ranljivosti zaupno sporočite na [email protected]. Varnost je eden od štirih profilov skladnosti.
Ta spletna stran ne nastavlja piškotkov, ne uporablja sledilnikov in ničesar ne nalaga z drugih strežnikov.
Za razvijalce
Tri pogodbe OpenAPI, JSON Schema, izmišljena testna znamka in zbirka preverjanj skladnosti. Go SDK in orodje obx sta pripravljena za uporabo, deluje pa vsak odjemalec HTTP.
$ 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"]
}Pogosta vprašanja
Standard in programska oprema sta brezplačna. Če gostite sami, plačate samo gostovanje. Ponudnik ima lastne cene, ki jih najdete na njegovem spletnem mestu.
Za osnove ne. Portal namestite z enim klikom, načrtovani uvoz s spletnega naslova, strežnika SFTP ali vedra pa ne zahteva kode. Razvijalec pomaga, če želite neposredno povezati PIM ali ERP.
Ne. Vsaka znamka upravlja lasten portal, po želji na lastni domeni. Ni osrednje platforme, ki bi hranila vašo vsebino.
Vi. Trgovci zaprosijo za dostop, vi pa vsako prošnjo odobrite ali zavrnete. Izberete tudi, katere znamke trgovec vidi in ali lahko prenaša izvirnike.
Postavite lasten portal ali nam povejte o svojih sistemih in trgovcih ter soustvarjajte prvo izdajo.
Prepustite ga ponudniku ali ga gostite sami brezplačno, z enim klikom ali enim ukazom. Možnosti gostovanja
Ena datoteka CSV in fotografije s stalnim imenom. Vaš PIM, ERP ali navadna mapa jih dostavi vsako noč, brez ročnega dela. Avtomatizacija
Trgovci se prijavijo, prilepijo seznam kod EAN in prenesejo. Njihovi sistemi dobijo isto vsebino prek standardnega API-ja. Za trgovce