Verżjoni 0.1. Il-verżjoni 0.1 ħarġet. L-ispeċifikazzjoni u s-software huma ħielsa biex tużahom.

Standard miftuħ · Software b'xejn

Il-kontenut tal-prodotti tiegħek, lest għal kull bejjiegħ.

Open Brand Exchange huwa standard miftuħ għal kif il-bejjiegħa jieħdu r-ritratti tal-prodotti u d-data tal-oġġetti mingħand marka: f'portal fil-browser, bħala zip jew spreadsheet, jew dritt fis-software tagħhom permezz ta' API wieħed. Kif il-kontenut jasal fil-portal tiegħek tiddeċiedi int.

Ibda bħala marka Jien bejjiegħ
Miftuħ
standard, CC-BY-4.0
3
edizzjonijiet tal-portal
61
kontroll ta' konformità
25
lingwa
€0
miżata tal-liċenzja
Il-portal tal-marka fittizja Kestrel kif jarah bejjiegħ: tmien oġġetti b'filtri għall-marka, it-tip ta' prodott u l-kulur.
GET/obx/v1/changesX'jirċievi s-software ta' bejjiegħ
{
  "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
}

Kif jaħdem

Sors wieħed. Il-bejjiegħa jieħdu dak li għandhom bżonn.

Il-kontenut tiegħek jinsab fil-portal tiegħek stess. Ix-xerrejja jfittxu u jniżżlu l-fajls fil-browser; is-software tagħhom jaqra l-istess kontenut permezz tal-API.

  1. Is-sistemi tiegħek

    • PIM
    • ERP
    • DAM
    • Folder tal-esportazzjoni

  2. Kif jidħol il-kontenut

    • Importazzjoni skedata
    • L-għodda obx
    • GitHub Action
    • API tat-tlugħ

  3. Il-portal tiegħek

    brands.yourbrand.com
    • Katalgu u ritratti
    • Aċċess għal kull bejjiegħ
    • Statistika tal-użu

  4. Il-bejjiegħa tiegħek

    Xerrejja, fil-browser

    • Tfittxija u lista tal-EAN
    • Downloads f'zip u CSV

    Is-software tagħhom, permezz tal-API

    • Ħanut online u PIM
    • POS u għodod tal-kontenut
Kif il-kontenut jgħaddi mis-sistemi ta' marka, permezz tal-portal tagħha stess, sal-bejjiegħa tagħha.

01 Portal

Portal għax-xerrejja tal-bejjiegħa tiegħek.

Ix-xerrejja jidħlu fil-portal tiegħek, iwaħħlu l-EANs mill-ordni tagħhom u jniżżlu eżatt dak li għandhom bżonn: ritratt wieħed, oġġett wieħed jew zip ta' għażla sħiħa.

  • Fittex u ffiltra skont il-marka, l-istaġun, it-tip ta' prodott u l-kulur
  • Waħħal lista tal-EAN u ara mill-ewwel x'hemm u x'jonqos
  • Oriġinali, web (2000 px) jew kwadru, flimkien mad-data tal-oġġetti bħala spreadsheet
  • L-isem, il-logo u d-dominju tiegħek: “Kestrel · Portal għall-bejjiegħa”
Arah minn għajnejn bejjiegħ
Bejjiegħ iwaħħal sitt EANs fil-portal tal-marka: ħamsa jinstabu, wieħed mhux fil-katalgu.

02 API

API wieħed, l-istess għal kull marka.

Is-software tal-bejjiegħa jġib kollox darba u mbagħad biss dak li nbidel, inkluż dak li tirtira. Kull ritratt jasal bid-drittijiet tal-użu, id-data tal-embargo u l-oriġini tal-IA tiegħu.

  • L-ewwel kopja sħiħa, imbagħad il-bidliet biss
  • Tfittxija bl-EAN, marbuta mal-oġġett u d-daqs it-tajjeb
  • Verżjonijiet web, kwadri u żgħar; l-oriġinali meta tippermettihom
  • Fornitur tas-software jibnih darba u jaħdem ma' kull marka
Aqra r-referenza tal-API
GET/obx/v1/changesAsset
{
  "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 Is-sistemi tiegħek

Kompli aħdem kif taħdem issa.

L-istandard jirrigwarda kif il-bejjiegħa jieħdu l-kontenut. Kif il-kontenut tiegħek jasal fil-portal tagħżel int: importazzjoni bil-lejl minn indirizz web, SFTP jew S3, folder tal-esportazzjoni, jew l-għodda obx mill-linja tal-kmand.

  • Importazzjoni bil-lejl minn indirizz web, SFTP jew S3, mingħajr kodiċi
  • L-għodda obx għal Windows, macOS u Linux tibgħat biss dak li nbidel
  • Riċetti għal cron, GitHub Actions, n8n, Make u Zapier
  • Format CSV wieħed u regola waħda għall-ismijiet tar-ritratti
Ara r-riċetti tal-awtomazzjoni
Terminal
$ 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
publish.ymlGitHub Action
# .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: export

Għal min hu

Għall-marki u għall-bejjiegħa.

Għall-marki

M'hemmx għalfejn tibqa' tibgħat fajls. Il-bejjiegħa jieħdu dak li għandhom bżonn, u int tiddeċiedi min jieħu xiex.

  • Il-portal tiegħek, fuq id-dominju tiegħek
  • Tapprova kull bejjiegħ u tiddeċiedi x'jara
  • Ara min iniżżel xiex, għal kull bejjiegħ
  • Ospitah int stess b'xejn, jew agħżel fornitur u ħallih meta trid
Skopri għall-marki

Għall-bejjiegħa

Kull marka f'format wieħed konsistenti, fil-browser jew dritt fis-software tiegħek.

  • Waħħal il-lista tal-EAN u ikseb ir-ritratti t-tajbin għal kull daqs
  • Niżżel zips u data tal-oġġetti, lesti għall-ħanut tiegħek
  • Konnessjoni waħda għal kull marka fuq l-istandard
  • Drittijiet tal-użu u dati tal-embargo ma' kull ritratt
Skopri għall-bejjiegħa

Hosting

Ħaddmu fejn trid. Ħallas il-hosting biss.

Tliet edizzjonijiet tal-istess portal. Jgħaddu mill-istess testijiet ta' konformità u jitkellmu l-istess API, għalhekk tista' tgħaddi minn waħda għall-oħra.

  • L-eħfef

    Ospitat minn fornitur

    Jaħdem fuq
    Kumpanija tal-hosting jew aġenzija tħaddmu għalik
    Għandek bżonn
    Xejn tekniku
    Installazzjoni
    Iwaqqfuh flimkien miegħek
    Spiża
    Il-prezzijiet tal-fornitur
    Ara l-fornituri
  • Klikk waħda

    Portal għal Cloudflare

    Jaħdem fuq
    Cloudflare Workers, b'D1 u R2
    Għandek bżonn
    Kont ta' Cloudflare
    Installazzjoni
    Klikk waħda, imbagħad il-wizard tas-setup
    Spiża
    Pjan Workers Paid, madwar 5 dollari fix-xahar
    Installa fuq Cloudflare
  • Containers

    Portal għal Google Cloud u Docker

    Jaħdem fuq
    Google Cloud Run, jew kwalunkwe server b'Docker
    Għandek bżonn
    Kont ta' Google Cloud jew server b'Docker
    Installazzjoni
    Script wieħed jew kmand Docker wieħed
    Spiża
    Ħlas skont l-użu fuq Cloud Run, jew is-server tiegħek
    Installa b'Docker
  • Mingħajr kmandi

    Portal għal web hosting

    Jaħdem fuq
    Web hosting ordinarju b'PHP u database
    Għandek bżonn
    Programm FTP
    Installazzjoni
    Tella' zip, imbagħad l-installatur
    Spiża
    Il-hosting li diġà tħallas għalih
    Installa fuq web hosting

Governanza

Standard miftuħ, mhux pjattaforma.

Open Brand Exchange għandu jkun tal-marki, tal-bejjiegħa u tal-fornituri tas-software li jużawh, mhux ta' kumpanija waħda.

  • Speċifikazzjoni miftuħa

    Verżjoni 0.1, miktuba f'OpenAPI 3.1 u JSON Schema taħt CC-BY-4.0. Kulħadd jista' jimplimentaha, anki b'mod kummerċjali.

  • Testijiet ta' konformità

    61 kontroll awtomatiku f'erba' profili. Kull implimentazzjoni tiġi ttestjata bl-istess mod.

  • Liċenzji open source

    L-SDK, l-għodda obx u l-interfaċċa web huma Apache-2.0. It-tliet edizzjonijiet tal-portal huma AGPL-3.0, biex it-titjib jibqa' miftuħ.

  • Fondazzjoni li qed titwaqqaf

    Id-drittijiet tal-awtur, l-isem u d-dominju jgħaddu lill-Open Brand Exchange Foundation (qed titwaqqaf) hekk kif tiġi rreġistrata.

  • Sigurtà

    Irrapporta l-vulnerabbiltajiet b'mod privat lil [email protected]. Is-sigurtà hija wieħed mill-erba' profili ta' konformità.

  • Il-privatezza l-ewwel

    Dan is-sit ma jpoġġi l-ebda cookie, ma juża l-ebda tracker u ma jtella' xejn minn servers oħra.

Aqra kif huwa ggvernat

Żviluppaturi

Speċifikazzjoni li tista' tibni fuqha.

Tliet kuntratti OpenAPI, JSON Schemas, marka fittizja għat-test u testijiet ta' konformità. Il-Go SDK u l-għodda obx huma lesti għall-użu, u kull klijent HTTP jaħdem.

Terminal
$ curl https://brands.kestrel.example/.well-known/obx
200 OK · application/json
{
  "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"]
}

Mistoqsijiet frekwenti

L-ewwel mistoqsijiet tal-marki

Il-mistoqsijiet kollha
Kemm jiswa?

L-istandard u s-softwer huma b'xejn. Jekk tospitah int, tħallas biss għall-hosting tiegħek. Fornitur għandu l-prezzijiet tiegħu, li ssibhom fuq is-sit web tiegħu.

Għandna bżonn żviluppatur?

Mhux għall-bażi. Tista' tinstalla portal bi klikk waħda, u importazzjoni skedata minn indirizz web, server SFTP jew bucket ma teħtieġx kodiċi. Żviluppatur jgħin jekk trid tgħaqqad il-PIM jew l-ERP tiegħek direttament.

Din hija pjattaforma oħra li rridu ningħaqdu magħha?

Le. Kull marka tmexxi l-portal tagħha, fuq id-dominju tagħha jekk trid. M'hemm l-ebda pjattaforma ċentrali li żżomm il-kontenut tiegħek.

Min jiddeċiedi liema bejjiegħ jieħu aċċess?

Int. Il-bejjiegħa jitolbu aċċess, u int tapprova jew tirrifjuta kull talba. Tagħżel ukoll liema marki jara bejjiegħ u jekk jistax iniżżel l-oriġinali.

Ħalli l-bejjiegħa tiegħek jieħdu l-kontenut huma stess.

Waqqaf il-portal tiegħek, jew għidilna dwar is-sistemi u l-bejjiegħa tiegħek u għin fit-tiswir tal-ewwel ħarġa.

Ibda bħala marka Ibgħatilna email

  1. Waqqaf il-portal tiegħek

    Ħalli fornitur imexxih, jew ospitah int stess b'xejn bi klikk waħda jew kmand wieħed. Għażliet ta' hosting

  2. Ippubblika awtomatikament

    Fajl CSV wieħed u ritratti b'isem fiss. Il-PIM, l-ERP jew folder sempliċi jwassalhom kull lejl, mingħajr xogħol manwali. Awtomazzjoni

  3. Il-bejjiegħa jieħdu ħsieb il-bqija

    Il-bejjiegħa jidħlu, iwaħħlu l-lista tal-EAN tagħhom u jniżżlu. Is-sistemi tagħhom jiksbu l-istess kontenut permezz tal-API standard. Għall-bejjiegħa