Standard aperto · Software libero
Open Brand Exchange è uno standard aperto per il modo in cui i rivenditori ricevono foto e dati articolo da un brand: in un portale nel browser, come zip o foglio di calcolo, oppure direttamente nel loro software tramite un'unica API. Come i contenuti arrivano nel tuo portale lo decidi tu.
{
"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
}Come funziona
I tuoi contenuti stanno nel tuo portale. I buyer cercano e scaricano i file nel browser; il loro software legge gli stessi contenuti tramite l'API.
01 Portale
I buyer accedono al tuo portale, incollano gli EAN del loro ordine e scaricano esattamente ciò che serve: una foto, un articolo o lo zip di un'intera selezione.
02 API
Il software del rivenditore scarica tutto una volta e poi solo ciò che cambia, compreso ciò che ritiri. Ogni immagine arriva con diritti d'uso, data di embargo e provenienza IA.
{
"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 I tuoi sistemi
Lo standard riguarda il modo in cui i rivenditori prendono i contenuti. Come arrivano nel portale lo scegli tu: un import notturno da un indirizzo web, SFTP o S3, una cartella di export o lo strumento a riga di comando 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: exportPer chi è
Basta inviare file. I rivenditori prendono ciò che serve e tu decidi chi riceve cosa.
Ogni brand nello stesso formato coerente, nel browser o direttamente nel tuo software.
Hosting
Tre edizioni dello stesso portale. Superano gli stessi test di conformità e parlano la stessa API, quindi puoi passare dall'una all'altra.
Governance
Open Brand Exchange deve appartenere ai brand, ai rivenditori e alle software house che lo usano, non a una singola azienda.
Versione 0.1, scritta in OpenAPI 3.1 e JSON Schema con licenza CC-BY-4.0. Chiunque può implementarla, anche a fini commerciali.
61 controlli automatici in quattro profili. Ogni implementazione viene testata allo stesso modo.
L'SDK, lo strumento obx e l'interfaccia web sono Apache-2.0. Le tre edizioni del portale sono AGPL-3.0, così i miglioramenti restano aperti.
Il copyright, il nome e il dominio passeranno alla Open Brand Exchange Foundation (in via di costituzione) appena sarà registrata.
Segnala le vulnerabilità in privato a [email protected]. La sicurezza è uno dei quattro profili di conformità.
Questo sito non imposta cookie, non usa tracker e non carica nulla da altri server.
Sviluppatori
Tre contratti OpenAPI, JSON Schema, un brand di test immaginario e una suite di test di conformità. Il Go SDK e lo strumento obx sono pronti all'uso, e va bene qualsiasi client 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"]
}Domande frequenti
Lo standard e il software sono gratuiti. Se lo ospiti tu, paghi solo l'hosting. Un provider applica i propri prezzi, che trovi sul suo sito.
Non per le basi. Un portale si installa con un clic, e un import pianificato da un indirizzo web, un server SFTP o un bucket non richiede codice. Uno sviluppatore è utile se vuoi collegare direttamente il tuo PIM o ERP.
No. Ogni brand gestisce il proprio portale, sul proprio dominio se vuole. Non esiste una piattaforma centrale che detiene i tuoi contenuti.
Tu. I rivenditori chiedono l'accesso e tu approvi o rifiuti ogni richiesta. Scegli anche quali brand vede un rivenditore e se gli originali si possono scaricare.
Attiva il tuo portale, oppure raccontaci dei tuoi sistemi e dei tuoi rivenditori e aiutaci a dare forma alla prima versione.
Affidalo a un provider oppure ospitalo gratis da solo, con un clic o un comando. Opzioni di hosting
Un file CSV e foto con un nome fisso. Il tuo PIM, il tuo ERP o una semplice cartella li consegna ogni notte, senza lavoro manuale. Automazione
I rivenditori accedono, incollano la loro lista di EAN e scaricano. I loro software prendono gli stessi contenuti tramite l'API standard. Per i rivenditori