Standard deschis · Software gratuit

Conținutul produselor dvs., gata pentru fiecare comerciant.

Open Brand Exchange este un standard deschis pentru felul în care comercianții preiau fotografiile produselor și datele articolelor de la o marcă: într-un portal în browser, ca arhivă zip sau foaie de calcul, ori direct în propriul software, printr-un singur API. Cum ajunge conținutul în portalul dvs. hotărâți dvs.

Deschis
standard, CC-BY-4.0
3
ediții ale portalului
61
teste de conformitate
25
de limbi
0 €
taxă de licență
Portalul mărcii fictive Kestrel, așa cum îl vede un comerciant: opt articole cu filtre după marcă, tip de produs și culoare.
GET/obx/v1/changesCe primește software-ul unui comerciant
{
  "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
}

Cum funcționează

O singură sursă. Comercianții preiau ce le trebuie.

Conținutul dvs. stă în propriul portal. Cumpărătorii caută și descarcă fișiere în browser; sistemele lor citesc același conținut prin API.

  1. Sistemele dvs.

    • PIM
    • ERP
    • DAM
    • Folder de export
  2. Cum intră conținutul

    • Import programat
    • Instrumentul obx
    • GitHub Action
    • API de încărcare
  3. Portalul dvs.

    brands.yourbrand.com
    • Catalog și fotografii
    • Acces pe comerciant
    • Statistici de utilizare
  4. Comercianții dvs.

    Cumpărătorii, în browser

    • Căutare și listă de EAN
    • Descărcări zip și CSV

    Sistemele lor, prin API

    • Magazin online și PIM
    • POS și instrumente de conținut
Cum ajunge conținutul din sistemele unei mărci, prin propriul portal, la comercianții săi.

01 Portal

Un portal pentru cumpărătorii comercianților dvs.

Cumpărătorii se conectează la portalul dvs., lipesc codurile EAN din comandă și descarcă exact ce le trebuie: o fotografie, un articol sau un zip cu o selecție întreagă.

  • Căutare și filtre după marcă, sezon, tip de produs și culoare
  • Lipiți o listă de EAN și vedeți imediat ce există și ce lipsește
  • Originală, web (2000 px) sau pătrată, plus datele articolelor într-un tabel
  • Numele, logoul și domeniul dvs.: „Kestrel · Portal pentru comercianți”
Vedeți-l prin ochii unui comerciant
Un comerciant lipește șase coduri EAN în portalul mărcii: cinci sunt găsite, unul nu există în catalog.

02 API

Un singur API, același pentru fiecare marcă.

Software-ul comerciantului preia totul o dată, apoi doar ce s-a schimbat, inclusiv ce retrageți. Fiecare fotografie vine cu drepturile de utilizare, data de embargo și proveniența IA.

  • Mai întâi o copie completă, apoi doar modificările
  • Căutare după EAN, legată de articolul și mărimea corecte
  • Variante web, pătrată și miniatură; originalele, dacă le permiteți
  • Un furnizor de software îl integrează o dată și funcționează cu orice marcă
Citiți referința 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 Sistemele dvs.

Lucrați în continuare ca acum.

Standardul se referă la felul în care comercianții preiau conținutul. Cum ajunge conținutul dvs. în portal alegeți dvs.: un import nocturn de la o adresă web, prin SFTP sau S3, un folder de export sau instrumentul în linie de comandă obx.

  • Import nocturn de la o adresă web, prin SFTP sau S3, fără cod
  • Instrumentul obx pentru Windows, macOS și Linux trimite doar ce s-a schimbat
  • Rețete pentru cron, GitHub Actions, n8n, Make și Zapier
  • Un singur format CSV și o singură regulă de denumire pentru fotografii
Vedeți rețetele de automatizare
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

Pentru cine

Pentru mărci și pentru comercianți.

Pentru mărci

Nu mai trimiteți fișiere. Comercianții preiau ce le trebuie, iar dvs. decideți cine ce primește.

  • Propriul portal, pe propriul domeniu
  • Aprobați fiecare comerciant și decideți ce vede
  • Vedeți cine descarcă ce, pe fiecare comerciant
  • Găzduiți-l gratuit sau alegeți un furnizor și plecați oricând

Pentru comercianți

Toate mărcile într-un format unitar, în browser sau direct în software-ul dvs.

  • Lipiți lista de EAN și primiți fotografiile potrivite pentru fiecare mărime
  • Descărcați arhive zip și date despre articole, gata pentru magazin
  • O singură conexiune pentru toate mărcile standardului
  • Drepturi de utilizare și date de embargo la fiecare fotografie

Găzduire

Unde doriți. Plătiți doar găzduirea.

Trei ediții ale aceluiași portal. Trec aceleași teste de conformitate și vorbesc același API, deci puteți trece oricând de la una la alta.

  • Un clic

    Portal pentru Cloudflare

    Rulează pe
    Cloudflare Workers, cu D1 și R2
    Aveți nevoie de
    Un cont Cloudflare
    Configurare
    Un clic, apoi asistentul de configurare
    Cost
    Planul Workers Paid, circa 5 dolari pe lună
    Configurați pe Cloudflare
  • Containere

    Portal pentru Google Cloud și Docker

    Rulează pe
    Google Cloud Run sau orice server cu Docker
    Aveți nevoie de
    Un cont Google Cloud sau un server Docker
    Configurare
    Un script sau o comandă Docker
    Cost
    Plată la utilizare pe Cloud Run sau propriul server
    Configurați cu Docker
  • Fără comenzi

    Portal pentru găzduire web

    Rulează pe
    Găzduire web obișnuită, cu PHP și o bază de date
    Aveți nevoie de
    Un program FTP
    Configurare
    Încărcați un zip, apoi rulați instalatorul
    Cost
    Găzduirea pe care o plătiți deja
    Configurați pe găzduire web

Guvernanță

Un standard deschis, nu o platformă.

Open Brand Exchange trebuie să aparțină mărcilor, comercianților și furnizorilor de software care îl folosesc, nu unei singure companii.

  • Specificație deschisă

    Versiunea 0.1, scrisă în OpenAPI 3.1 și JSON Schema, sub licența CC-BY-4.0. Oricine o poate implementa, inclusiv în scop comercial.

  • Teste de conformitate

    61 de verificări automate în patru profiluri. Fiecare implementare este testată la fel.

  • Licențe open source

    SDK-ul, instrumentul obx și interfața web sunt Apache-2.0. Cele trei ediții ale portalului sunt AGPL-3.0, astfel încât îmbunătățirile rămân deschise.

  • O fundație în curs de înființare

    Drepturile de autor, numele și domeniul trec la Open Brand Exchange Foundation (în curs de constituire) imediat ce aceasta este înregistrată.

  • Securitate

    Raportați vulnerabilitățile confidențial la [email protected]. Securitatea este unul dintre cele patru profiluri de conformitate.

  • Confidențialitate înainte de toate

    Acest site nu setează cookie-uri, nu folosește trackere și nu încarcă nimic de pe alte servere.

Aflați cum este guvernat

Pentru dezvoltatori

O specificație pe care puteți construi.

Trei contracte OpenAPI, JSON Schema, o marcă de test fictivă și o suită de teste de conformitate. Go SDK și instrumentul obx sunt gata de folosit, iar orice client HTTP funcționează.

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"]
}

Întrebări frecvente

Primele întrebări ale mărcilor

Toate întrebările
Cât costă?

Standardul și software-ul sunt gratuite. Dacă îl găzduiți singuri, plătiți doar găzduirea. Un furnizor are propriile prețuri, pe care le găsiți pe site-ul său.

Avem nevoie de un dezvoltator?

Nu pentru elementele de bază. Un portal se instalează cu un clic, iar un import programat de la o adresă web, un server SFTP sau un bucket nu necesită cod. Un dezvoltator ajută dacă vreți să conectați direct PIM-ul sau ERP-ul.

Este încă o platformă la care trebuie să aderăm?

Nu. Fiecare marcă își administrează propriul portal, pe propriul domeniu dacă dorește. Nu există o platformă centrală care să vă dețină conținutul.

Cine decide ce comerciant primește acces?

Dvs. Comercianții solicită acces, iar dvs. aprobați sau respingeți fiecare cerere. Alegeți și ce mărci vede un comerciant și dacă poate descărca originalele.

Lăsați comercianții să preia singuri conținutul.

Configurați-vă propriul portal sau povestiți-ne despre sistemele și comercianții dvs. și ajutați-ne să modelăm prima versiune.

  1. Configurați-vă portalul

    Lăsați un furnizor să îl administreze sau găzduiți-l gratuit, cu un clic sau o singură comandă. Opțiuni de găzduire

  2. Publicați automat

    Un fișier CSV și fotografii cu nume fix. PIM-ul, ERP-ul sau un simplu folder le livrează în fiecare noapte, fără muncă manuală. Automatizare

  3. Restul îl fac comercianții

    Comercianții se autentifică, lipesc lista de coduri EAN și descarcă. Sistemele lor preiau același conținut prin API-ul standard. Pentru comercianți