Caighdeán oscailte · Bogearraí saor in aisce

Ábhar do tháirgí, réidh do gach miondíoltóir.

Is caighdeán oscailte é Open Brand Exchange a leagann amach conas a fhaigheann miondíoltóirí grianghraif táirgí agus sonraí earraí ó bhranda: i dtairseach sa bhrabhsálaí, mar zip nó scarbhileog, nó díreach isteach ina mbogearraí féin trí API amháin. Is fútsa atá sé conas a théann an t-ábhar isteach i do thairseach.

Oscailte
caighdeán, CC-BY-4.0
3
eagrán den tairseach
61
seiceáil chomhréireachta
25
teanga
€0
táille ceadúnais
Tairseach an bhranda fhicseanúil Kestrel mar a fheiceann miondíoltóir í: ocht n-earra le scagairí de réir branda, cineál táirge agus datha.
GET/obx/v1/changesAn méid a fhaigheann bogearraí miondíoltóra
{
  "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
}

Conas a oibríonn sé

Foinse amháin. Faigheann miondíoltóirí a bhfuil uathu.

Tá do chuid ábhair i do thairseach féin. Déanann ceannaitheoirí cuardach agus íoslódálann siad comhaid sa bhrabhsálaí; léann a gcuid bogearraí an t-ábhar céanna tríd an API.

  1. Do chórais

    • PIM
    • ERP
    • DAM
    • Fillteán easpórtála
  2. Ábhar a chur isteach

    • Iompórtáil sceidealaithe
    • An uirlis obx
    • GitHub Action
    • API uaslódála
  3. Do thairseach

    brands.yourbrand.com
    • Catalóg agus grianghraif
    • Rochtain do gach miondíoltóir
    • Staitisticí úsáide
  4. Do mhiondíoltóirí

    Ceannaitheoirí, sa bhrabhsálaí

    • Cuardach agus liosta EAN
    • Íoslódálacha zip agus CSV

    A gcuid bogearraí, tríd an API

    • Siopa gréasáin agus PIM
    • POS agus uirlisí ábhair
Conas a ghluaiseann ábhar ó chórais branda, trína thairseach féin, go dtí a mhiondíoltóirí.

01 Tairseach

Tairseach do cheannaitheoirí do mhiondíoltóirí.

Logálann ceannaitheoirí isteach i do thairseach, greamaíonn siad na EANanna óna n-ordú agus íoslódálann siad díreach a bhfuil uathu: grianghraf amháin, earra amháin nó zip de rogha iomlán.

  • Cuardaigh agus scag de réir branda, séasúir, cineál táirge agus datha
  • Greamaigh liosta EAN agus feic láithreach cad atá ann agus cad atá in easnamh
  • Bunleagan, gréasán (2000 px) nó cearnóg, móide sonraí earraí mar scarbhileog
  • D'ainm, do lógó agus d'fhearann: “Kestrel · Tairseach miondíoltóirí”
Féach air trí shúile miondíoltóra
Greamaíonn miondíoltóir sé EAN isteach i dtairseach an bhranda: aimsítear cúig cinn, níl ceann amháin sa chatalóg.

02 API

API amháin, an ceann céanna do gach branda.

Faigheann bogearraí na miondíoltóirí gach rud uair amháin agus ansin na hathruithe amháin, lena n-áirítear a dtarraingíonn tú siar. Tagann gach grianghraf lena chearta úsáide, dáta lánchoisc agus bunús IS.

  • Cóip iomlán ar dtús, ansin na hathruithe amháin
  • Cuardach de réir EAN, meaitseáilte leis an earra agus an méid ceart
  • Leaganacha gréasáin, cearnacha agus mionsamhla; bunleaganacha nuair a cheadaíonn tú iad
  • Tógann soláthraí bogearraí é uair amháin, agus oibríonn sé le gach branda
Léigh an tagairt 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 Do chórais

Lean ort ag obair mar a dhéanann tú anois.

Baineann an caighdeán leis an gcaoi a bhfaigheann miondíoltóirí ábhar. Is fútsa conas a théann d'ábhar isteach sa tairseach: iompórtáil gach oíche ó sheoladh gréasáin, SFTP nó S3, fillteán easpórtála, nó an uirlis líne ordaithe obx.

  • Iompórtáil gach oíche ó sheoladh gréasáin, SFTP nó S3, gan chód
  • Ní sheolann an uirlis obx do Windows, macOS agus Linux ach a bhfuil athraithe
  • Oidis do cron, GitHub Actions, n8n, Make agus Zapier
  • Formáid CSV amháin agus riail ainmniúcháin amháin do ghrianghraif
Féach ar na hoidis uathoibrithe
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

Cé dó é

Do bhrandaí agus do mhiondíoltóirí.

Do bhrandaí

Ní gá comhaid a sheoladh thart níos mó. Faigheann miondíoltóirí a bhfuil uathu, agus is tusa a shocraíonn cé a fhaigheann céard.

  • Do thairseach féin, ar d'fhearann féin
  • Ceadaíonn tú gach miondíoltóir agus socraíonn tú cad a fheiceann siad
  • Feic cé a íoslódálann cad, de réir miondíoltóra
  • Óstáil tú féin é saor in aisce, nó roghnaigh soláthraí agus fág am ar bith

Do mhiondíoltóirí

Gach branda i bhformáid chomhsheasmhach amháin, i do bhrabhsálaí nó díreach isteach i do bhogearraí.

  • Greamaigh do liosta EAN agus faigh na grianghraif chearta do gach méid
  • Íoslódáil zipeanna agus sonraí earraí, réidh do do shiopa
  • Nasc amháin do gach branda ar an gcaighdeán
  • Cearta úsáide agus dátaí lánchoisc le gach grianghraf

Óstáil

Rith é áit ar bith. Íoc as óstáil amháin.

Trí eagrán den tairseach chéanna. Éiríonn leo sna tástálacha comhréireachta céanna agus labhraíonn siad an API céanna, mar sin is féidir leat bogadh ó cheann go ceann.

  • Cliceáil amháin

    Tairseach do Cloudflare

    Ritheann ar
    Cloudflare Workers, le D1 agus R2
    Teastaíonn uait
    Cuntas Cloudflare
    Socrú
    Cliceáil amháin, ansin an draoi socraithe
    Costas
    Plean Workers Paid, thart ar 5 dollar sa mhí
    Socraigh ar Cloudflare
  • Coimeádáin

    Tairseach do Google Cloud agus Docker

    Ritheann ar
    Google Cloud Run, nó aon fhreastalaí le Docker
    Teastaíonn uait
    Cuntas Google Cloud nó óstach Docker
    Socrú
    Script amháin nó ordú Docker amháin
    Costas
    Íoc de réir úsáide ar Cloud Run, nó do fhreastalaí féin
    Socraigh le Docker
  • Gan orduithe

    Tairseach d'óstáil gréasáin

    Ritheann ar
    Gnáthóstáil ghréasáin le PHP agus bunachar sonraí
    Teastaíonn uait
    Clár FTP
    Socrú
    Uaslódáil zip, ansin an suiteálaí
    Costas
    An óstáil a íocann tú as cheana
    Socraigh ar óstáil ghréasáin

Rialachas

Caighdeán oscailte, ní ardán.

Ba cheart go mbeadh Open Brand Exchange ag na brandaí, na miondíoltóirí agus na soláthraithe bogearraí a úsáideann é, ní ag cuideachta amháin.

  • Sonraíocht oscailte

    Leagan 0.1, scríofa mar OpenAPI 3.1 agus JSON Schema faoi CC-BY-4.0. Is féidir le duine ar bith í a chur i bhfeidhm, go tráchtála freisin.

  • Tástálacha comhréireachta

    61 seiceáil uathoibríoch i gceithre phróifíl. Déantar gach cur chun feidhme a thástáil ar an mbealach céanna.

  • Ceadúnais foinse oscailte

    Tá an SDK, an uirlis obx agus an comhéadan gréasáin faoi Apache-2.0. Tá na trí eagrán den tairseach faoi AGPL-3.0, ionas go bhfanann feabhsuithe oscailte.

  • Fondúireacht á bunú

    Aistreofar an cóipcheart, an t-ainm agus an fearann chuig an Open Brand Exchange Foundation (á bunú) chomh luath agus a bheidh sí cláraithe.

  • Slándáil

    Tuairiscigh leochaileachtaí go príobháideach chuig [email protected]. Tá slándáil ar cheann de na ceithre phróifíl comhréireachta.

  • Príobháideachas ar dtús

    Ní shocraíonn an suíomh seo fianáin, ní úsáideann sé rianairí agus ní lódálann sé aon rud ó fhreastalaithe eile.

Léigh conas a rialaítear é

Forbróirí

Sonraíocht ar féidir leat tógáil uirthi.

Trí chonradh OpenAPI, JSON Schemas, branda tástála ficseanúil agus tástálacha comhréireachta. Tá an Go SDK agus an uirlis obx réidh le húsáid, agus oibríonn aon chliant HTTP.

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

Ceisteanna coitianta

Na chéad cheisteanna a chuireann brandaí

Gach ceist
Cé mhéad a chosnaíonn sé?

Tá an caighdeán agus na bogearraí saor in aisce. Má óstálann tú féin é, ní íocann tú ach as d'óstáil. Tá a phraghsanna féin ag soláthraí, agus gheobhaidh tú iad ar a shuíomh gréasáin.

An dteastaíonn forbróir uainn?

Ní don bhunobair. Is féidir leat tairseach a shuiteáil le cliceáil amháin, agus ní theastaíonn cód ó allmhairiú sceidealta ó sheoladh gréasáin, freastalaí SFTP nó buicéad. Cabhraíonn forbróir más mian leat do PIM nó ERP a nascadh go díreach.

An ardán eile é seo a gcaithfimid a bheith páirteach ann?

Ní hea. Reáchtálann gach branda a thairseach féin, ar a fhearann féin más mian leis. Níl aon ardán lárnach a choinníonn d'ábhar.

Cé a chinneann cén miondíoltóir a fhaigheann rochtain?

Tusa. Iarrann miondíoltóirí rochtain, agus ceadaíonn nó diúltaíonn tú gach iarratas. Roghnaíonn tú freisin cé na brandaí a fheiceann miondíoltóir agus an féidir bunleaganacha a íoslódáil.

Lig do do mhiondíoltóirí é a fháil iad féin.

Cuir do thairseach féin ar bun, nó inis dúinn faoi do chórais agus do mhiondíoltóirí agus cabhraigh leis an gcéad eisiúint a mhúnlú.

  1. Cuir do thairseach ar bun

    Lig do sholáthraí é a reáchtáil, nó óstáil tú féin é saor in aisce le cliceáil amháin nó ordú amháin. Roghanna óstála

  2. Foilsigh go huathoibríoch

    Comhad CSV amháin agus grianghraif le hainm seasta. Seachadann do PIM, ERP nó fillteán simplí iad gach oíche, gan obair láimhe. Uathoibriú

  3. Déanann do mhiondíoltóirí an chuid eile

    Logálann miondíoltóirí isteach, greamaíonn siad a liosta EAN agus íoslódálann siad. Faigheann a gcórais an t-ábhar céanna tríd an API caighdeánach. Do mhiondíoltóirí