Otwarty standard · Bezpłatne oprogramowanie
Open Brand Exchange to otwarty standard określający, jak sprzedawcy pobierają od marki zdjęcia produktów i dane artykułów: w portalu w przeglądarce, jako ZIP lub arkusz kalkulacyjny albo bezpośrednio do własnego oprogramowania przez jedno API. To, jak treści trafiają do Twojego portalu, zależy od Ciebie.
{
"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
}Jak to działa
Twoje treści są w Twoim portalu. Zakupowcy wyszukują je i pobierają pliki w przeglądarce, a ich oprogramowanie czyta te same treści przez API.
01 Portal
Zakupowcy logują się do Twojego portalu, wklejają kody EAN z zamówienia i pobierają dokładnie to, czego potrzebują: jedno zdjęcie, jeden artykuł albo ZIP z całym wyborem.
02 API
Oprogramowanie sprzedawców pobiera wszystko raz, a potem tylko zmiany, także to, co wycofasz. Każde zdjęcie ma prawa do użycia, datę embarga i informację o pochodzeniu 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 Twoje systemy
Standard dotyczy tego, jak sprzedawcy pobierają treści. To, jak Twoje treści trafiają do portalu, wybierasz sam: nocny import z adresu WWW, SFTP lub S3, folder eksportu albo narzędzie wiersza poleceń 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: exportDla kogo
Koniec z rozsyłaniem plików. Sprzedawcy pobierają to, czego potrzebują, a Ty decydujesz, kto co dostaje.
Każda marka w jednym spójnym formacie, w przeglądarce lub prosto w Twoim oprogramowaniu.
Hosting
Trzy edycje tego samego portalu. Przechodzą te same testy zgodności i mówią tym samym API, więc możesz przejść z jednej na drugą.
Zarządzanie
Open Brand Exchange ma należeć do marek, sprzedawców i producentów oprogramowania, którzy z niego korzystają, a nie do jednej firmy.
Wersja 0.1, zapisana jako OpenAPI 3.1 i JSON Schema na licencji CC-BY-4.0. Każdy może ją wdrożyć, także komercyjnie.
61 automatycznych testów w czterech profilach. Każda implementacja jest testowana w ten sam sposób.
SDK, narzędzie obx i interfejs WWW są na licencji Apache-2.0. Trzy edycje portalu są na AGPL-3.0, więc ulepszenia pozostają otwarte.
Prawa autorskie, nazwa i domena przejdą na Open Brand Exchange Foundation (w organizacji), gdy tylko zostanie zarejestrowana.
Luki zgłaszaj poufnie na adres [email protected]. Bezpieczeństwo to jeden z czterech profili zgodności.
Ta strona nie ustawia plików cookie, nie używa trackerów i niczego nie ładuje z innych serwerów.
Dla programistów
Trzy kontrakty OpenAPI, JSON Schema, fikcyjna marka testowa i zestaw testów zgodności. Go SDK i narzędzie obx są gotowe do użycia, a zadziała każdy klient 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"]
}Najczęstsze pytania
Standard i oprogramowanie są bezpłatne. Jeśli hostujesz samodzielnie, płacisz tylko za hosting. Dostawca ma własne ceny, które znajdziesz na jego stronie.
Nie do podstaw. Portal instalujesz jednym kliknięciem, a zaplanowany import z adresu WWW, serwera SFTP lub zasobnika nie wymaga kodu. Programista przyda się, jeśli chcesz bezpośrednio podłączyć PIM lub ERP.
Nie. Każda marka prowadzi własny portal, jeśli chce, we własnej domenie. Nie ma centralnej platformy przechowującej Twoje treści.
Ty. Sprzedawcy proszą o dostęp, a Ty akceptujesz lub odrzucasz każdą prośbę. Wybierasz też, jakie marki widzi sprzedawca i czy może pobierać oryginały.
Uruchom własny portal albo opowiedz nam o swoich systemach i sprzedawcach i współtwórz pierwsze wydanie.
Powierz go dostawcy albo hostuj samodzielnie za darmo, jednym kliknięciem lub jednym poleceniem. Opcje hostingu
Jeden plik CSV i zdjęcia o stałych nazwach. PIM, ERP albo zwykły folder dostarcza je co noc, bez ręcznej pracy. Automatyzacja
Sprzedawcy logują się, wklejają listę kodów EAN i pobierają. Ich systemy pobierają te same treści przez standardowe API. Dla sprzedawców