Otvoreni standard · Besplatan softver
Open Brand Exchange je otvoreni standard za to kako trgovci preuzimaju fotografije proizvoda i podatke o artiklima od marke: na portalu u pregledniku, kao ZIP ili tablicu, ili izravno u vlastiti softver putem jednog API-ja. Kako sadržaj dolazi na vaš portal, odlučujete 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 funkcionira
Vaš sadržaj nalazi se na vašem vlastitom portalu. Nabavljači pretražuju i preuzimaju datoteke u pregledniku, a njihov softver čita isti sadržaj putem API-ja.
01 Portal
Nabavljači se prijave u vaš portal, zalijepe EAN kodove iz narudžbe i preuzmu točno ono što trebaju: jednu fotografiju, jedan artikl ili ZIP cijelog odabira.
02 API
Softver trgovaca jednom preuzme sve, a zatim samo promjene, uključujući ono što povučete. Svaka fotografija stiže s pravima korištenja, datumom embarga i podrijetlom umjetne inteligencije.
{
"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 sustavi
Standard određuje kako trgovci preuzimaju sadržaj. Kako vaš sadržaj dolazi na portal, birate sami: noćni uvoz s web-adrese, SFTP-a ili S3-a, mapa za izvoz ili alat obx za naredbeni redak.
$ 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
Nema više slanja datoteka. Trgovci sami preuzimaju ono što im treba, a vi odlučujete tko što dobiva.
Svaka marka u jednom dosljednom formatu, u pregledniku ili izravno u vašem softveru.
Hosting
Tri izdanja istog portala. Prolaze iste provjere sukladnosti i govore isti API, pa možete prijeći s jednog na drugo.
Upravljanje
Open Brand Exchange treba pripadati markama, trgovcima i dobavljačima softvera koji ga koriste, a ne jednoj tvrtki.
Verzija 0.1, zapisana kao OpenAPI 3.1 i JSON Schema pod licencom CC-BY-4.0. Svatko je smije implementirati, i komercijalno.
61 automatska provjera u četiri profila. Svaka se implementacija testira na isti način.
SDK, alat obx i web-sučelje su pod Apache-2.0. Tri izdanja portala su pod AGPL-3.0, pa poboljšanja ostaju otvorena.
Autorska prava, naziv i domena prelaze na Open Brand Exchange Foundation (u osnivanju) čim bude registrirana.
Ranjivosti prijavite povjerljivo na [email protected]. Sigurnost je jedan od četiri profila sukladnosti.
Ova web-stranica ne postavlja kolačiće, ne koristi alate za praćenje i ništa ne učitava s drugih poslužitelja.
Za programere
Tri OpenAPI ugovora, JSON Schema, izmišljena testna marka i skup provjera sukladnosti. Go SDK i alat obx spremni su za upotrebu, a radi i bilo koji HTTP klijent.
$ 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"]
}Česta pitanja
Standard i softver su besplatni. Ako hostate sami, plaćate samo hosting. Pružatelj usluge ima vlastite cijene, koje ćete pronaći na njegovoj stranici.
Za osnove ne. Portal instalirate jednim klikom, a planirani uvoz s web adrese, SFTP poslužitelja ili spremnika ne zahtijeva kod. Programer pomaže ako želite izravno povezati PIM ili ERP.
Ne. Svaka marka vodi vlastiti portal, po želji na vlastitoj domeni. Ne postoji središnja platforma koja drži vaš sadržaj.
Vi. Trgovci traže pristup, a vi odobravate ili odbijate svaki zahtjev. Birate i koje marke trgovac vidi te smije li preuzimati originale.
Postavite vlastiti portal ili nam recite nešto o svojim sustavima i trgovcima i pomozite oblikovati prvo izdanje.
Prepustite ga pružatelju usluge ili ga hostajte sami besplatno, jednim klikom ili jednom naredbom. Mogućnosti hostinga
Jedna CSV datoteka i fotografije sa stalnim nazivom. Vaš PIM, ERP ili obična mapa isporučuje ih svake noći, bez ručnog rada. Automatizacija
Trgovci se prijave, zalijepe popis EAN kodova i preuzmu. Njihovi sustavi dohvaćaju isti sadržaj putem standardnog API-ja. Za trgovce