Avatud standard · Vaba tarkvara
Open Brand Exchange on avatud standard selle kohta, kuidas edasimüüjad kaubamärgilt tootefotod ja tooteandmed kätte saavad: brauseris avatavast portaalist, zip-faili või tabelina või ühe API kaudu otse oma tarkvarasse. Kuidas sisu teie portaali jõuab, otsustate ise.
{
"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
}Kuidas see toimib
Teie sisu on teie enda portaalis. Ostjad otsivad ja laadivad faile brauseris alla, nende tarkvara loeb sama sisu API kaudu.
01 Portaal
Ostjad logivad teie portaali sisse, kleebivad tellimuse EAN-koodid ja laadivad alla täpselt selle, mida vajavad: ühe foto, ühe toote või terve valiku zip-failina.
02 API
Edasimüüjate tarkvara toob kõik ühe korra ja seejärel ainult muudatused, ka selle, mille tagasi võtate. Iga fotoga tulevad kaasa kasutusõigused, embargo kuupäev ja tehisintellekti päritolu.
{
"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 Teie süsteemid
Standard määrab, kuidas edasimüüjad sisu kätte saavad. Kuidas teie sisu portaali jõuab, valite ise: öine import veebiaadressilt, SFTP-st või S3-st, ekspordikaust või käsurea tööriist 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: exportKellele
Failide saatmine jääb ära. Edasimüüjad võtavad ise, mida vajavad, ja teie otsustate, kes mida saab.
Kõik kaubamärgid ühes ühtses vormingus, brauseris või otse teie tarkvaras.
Majutus
Sama portaali kolm väljaannet. Need läbivad samad vastavustestid ja räägivad sama API-t, nii et saate ühelt teisele üle minna.
Juhtimine
Open Brand Exchange peaks kuuluma kaubamärkidele, edasimüüjatele ja tarkvaratarnijatele, kes seda kasutavad, mitte ühele ettevõttele.
Versioon 0.1, kirjutatud OpenAPI 3.1 ja JSON Schema vormingus litsentsiga CC-BY-4.0. Igaüks võib selle teostada, ka ärilistel eesmärkidel.
61 automaatset testi neljas profiilis. Iga teostust testitakse ühtemoodi.
SDK, tööriist obx ja veebiliides on Apache-2.0 all. Kolm portaali väljaannet on AGPL-3.0 all, nii et täiustused jäävad avatuks.
Autoriõigus, nimi ja domeen lähevad üle sihtasutusele Open Brand Exchange Foundation (asutamisel), kui see on registreeritud.
Teatage turvanõrkustest konfidentsiaalselt aadressil [email protected]. Turvalisus on üks neljast vastavusprofiilist.
See veebisait ei sea küpsiseid, ei kasuta jälgijaid ega laadi midagi teistest serveritest.
Arendajatele
Kolm OpenAPI lepingut, JSON-skeemid, väljamõeldud testkaubamärk ja vastavustestid. Go SDK ja tööriist obx on kasutusvalmis ning sobib iga 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"]
}KKK
Standard ja tarkvara on tasuta. Kui majutate ise, maksate ainult majutuse eest. Teenusepakkujal on oma hinnad, mille leiate tema veebisaidilt.
Põhitegevuseks mitte. Portaali saab paigaldada ühe klõpsuga ning ajastatud import veebiaadressilt, SFTP-serverist või ämbrist ei vaja koodi. Arendaja aitab, kui soovite PIM-i või ERP otse ühendada.
Ei. Iga kaubamärk haldab oma portaali, soovi korral oma domeenil. Puudub keskne platvorm, mis teie sisu hoiaks.
Teie. Edasimüüjad taotlevad juurdepääsu ja teie kinnitate või lükkate iga taotluse tagasi. Valite ka, milliseid kaubamärke edasimüüja näeb ja kas originaale tohib alla laadida.
Seadistage oma portaal või rääkige meile oma süsteemidest ja edasimüüjatest ning aidake kujundada esimest väljalaset.
Laske teenusepakkujal seda hallata või majutage ise tasuta ühe klõpsu või ühe käsuga. Majutusvõimalused
Üks CSV-fail ja kindla nimega fotod. Teie PIM, ERP või tavaline kaust toimetab need kohale igal ööl, ilma käsitööta. Automatiseerimine
Edasimüüjad logivad sisse, kleebivad oma EAN-loendi ja laadivad alla. Nende süsteemid saavad sama sisu standardse API kaudu. Edasimüüjatele