Nyílt szabvány · Ingyenes szoftver
Az Open Brand Exchange nyílt szabvány arra, hogyan kapják meg a viszonteladók egy márka termékfotóit és termékadatait: böngészőben egy portálon, ZIP-ként vagy táblázatként, vagy egyetlen API-n keresztül közvetlenül a saját szoftverükbe. Hogy a tartalom hogyan kerül a portáljára, azt Ön dönti el.
{
"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
}Így működik
A tartalma a saját portálján van. A beszerzők böngészőben keresnek és töltenek le fájlokat, a szoftvereik pedig ugyanezt a tartalmat az API-n keresztül olvassák.
01 Portál
A beszerzők belépnek a portáljára, beillesztik a rendelésük EAN-kódjait, és pontosan azt töltik le, amire szükségük van: egy fotót, egy cikket vagy egy teljes válogatás ZIP-jét.
02 API
A viszonteladók szoftvere egyszer mindent letölt, utána csak a változásokat, azt is, amit visszavon. Minden fotó felhasználási jogokkal, embargódátummal és MI-eredetinformációval érkezik.
{
"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 Az Ön rendszerei
A szabvány arról szól, hogyan töltenek le a viszonteladók. Hogy a tartalma hogyan kerül a portálra, az az Ön döntése: éjszakai import webcímről, SFTP-ről vagy S3-ról, egy exportmappa, vagy az obx parancssori eszköz.
$ 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: exportKinek szól
Nem kell többé fájlokat küldözgetnie. A viszonteladók letöltik, amire szükségük van, és Ön dönti el, ki mit kap.
Minden márka egyetlen egységes formátumban, böngészőben vagy közvetlenül a szoftverében.
Üzemeltetés
Ugyanannak a portálnak három kiadása. Ugyanazokon a megfelelőségi ellenőrzéseken mennek át, és ugyanazt az API-t beszélik, így bármikor válthat közöttük.
Irányítás
Az Open Brand Exchange-nek az azt használó márkákhoz, viszonteladókhoz és szoftverszállítókhoz kell tartoznia, nem egyetlen céghez.
A 0.1-es verzió OpenAPI 3.1 és JSON Schema formátumú, CC-BY-4.0 licenccel. Bárki megvalósíthatja, üzleti célra is.
61 automatikus ellenőrzés négy profilban. Minden implementációt ugyanígy tesztelünk.
Az SDK, az obx eszköz és a webes felület Apache-2.0 licencű. A három portálkiadás AGPL-3.0 licencű, így a fejlesztések nyíltak maradnak.
A szerzői jog, a név és a domain a(z) Open Brand Exchange Foundation (alapítás alatt) tulajdonába kerül, amint az alapítványt bejegyzik.
Sebezhetőséget bizalmasan jelentsen itt: [email protected]. A biztonság a négy megfelelőségi profil egyike.
Ez a weboldal nem használ sütiket és nyomkövetőket, és semmit sem tölt be más szerverekről.
Fejlesztőknek
Három OpenAPI-szerződés, JSON Schemák, egy kitalált tesztmárka és egy megfelelőségi tesztcsomag. A Go SDK és az obx eszköz használatra kész, és bármely HTTP-kliens működik.
$ 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"]
}Gyakori kérdések
A szabvány és a szoftver ingyenes. Ha maga üzemelteti, csak a tárhelyért fizet. A szolgáltatóknak saját áraik vannak, ezeket a weboldalukon találja.
Az alapokhoz nem. A portál egy kattintással telepíthető, és egy webcímről, SFTP-szerverről vagy tárolóból érkező ütemezett import nem igényel kódot. Fejlesztő akkor segít, ha a PIM-et vagy ERP-t közvetlenül akarja bekapcsolni.
Nem. Minden márka saját portált üzemeltet, ha szeretné, saját domainen. Nincs központi platform, amely a tartalmát tárolná.
Ön. A viszonteladók hozzáférést kérnek, Ön pedig minden kérést jóváhagy vagy elutasít. Azt is Ön választja ki, mely márkákat lát egy viszonteladó, és letöltheti-e az eredetiket.
Állítsa be saját portálját, vagy meséljen nekünk rendszereiről és viszonteladóiról, és formálja velünk az első kiadást.
Bízza szolgáltatóra, vagy üzemeltesse ingyen maga, egy kattintással vagy egyetlen paranccsal. Üzemeltetési lehetőségek
Egy CSV-fájl és rögzített nevű fotók. A PIM, az ERP vagy egy egyszerű mappa minden éjjel leszállítja őket, kézi munka nélkül. Automatizálás
A viszonteladók bejelentkeznek, beillesztik EAN-listájukat és letöltenek. Rendszereik ugyanazt a tartalmat a szabványos API-n keresztül érik el. Viszonteladóknak