Avoin standardi · Vapaa ohjelmisto
Open Brand Exchange on avoin standardi sille, miten jälleenmyyjät hakevat brändin tuotekuvat ja tuotetiedot: selaimessa toimivasta portaalista, zip-tiedostona tai taulukkona tai suoraan omaan ohjelmistoonsa yhden APIn kautta. Sinä päätät, miten sisältö tulee portaaliisi.
{
"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
}Näin se toimii
Sisältösi on omassa portaalissasi. Ostajat hakevat ja lataavat tiedostoja selaimessa, ja heidän ohjelmistonsa lukevat saman sisällön APIn kautta.
01 Portaali
Ostajat kirjautuvat portaaliisi, liittävät tilauksensa EAN-koodit ja lataavat juuri sen, mitä tarvitsevat: yhden kuvan, yhden tuotteen tai kokonaisen valikoiman zip-tiedostona.
02 API
Jälleenmyyjien ohjelmistot hakevat kaiken kerran ja sen jälkeen vain muutokset, myös sen, mitä poistat. Jokaisen kuvan mukana tulevat käyttöoikeudet, julkaisuvapautuksen päivä ja tekoälyalkuperä.
{
"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 Omat järjestelmäsi
Standardi koskee sitä, miten jälleenmyyjät hakevat sisältöä. Sen, miten sisältösi päätyy portaaliin, valitset itse: yöllinen tuonti verkko-osoitteesta, SFTP:stä tai S3:sta, vientikansio tai komentorivityökalu 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: exportKenelle
Tiedostoja ei tarvitse enää lähetellä. Jälleenmyyjät hakevat itse, mitä tarvitsevat, ja sinä päätät, kuka saa mitäkin.
Kaikki brändit yhdessä yhtenäisessä muodossa, selaimessa tai suoraan ohjelmistossasi.
Ylläpito
Saman portaalin kolme versiota. Ne läpäisevät samat yhdenmukaisuustestit ja puhuvat samaa APIa, joten voit siirtyä versiosta toiseen.
Hallinto
Open Brand Exchangen pitäisi kuulua sitä käyttäville brändeille, jälleenmyyjille ja ohjelmistotoimittajille, ei yhdelle yritykselle.
Versio 0.1, kirjoitettu OpenAPI 3.1- ja JSON Schema -muodossa CC-BY-4.0-lisenssillä. Kuka tahansa saa toteuttaa sen, myös kaupallisesti.
61 automaattista testiä neljässä profiilissa. Jokainen toteutus testataan samalla tavalla.
SDK, obx-työkalu ja verkkokäyttöliittymä ovat Apache-2.0-lisensoituja. Kolme portaaliversiota ovat AGPL-3.0, joten parannukset pysyvät avoimina.
Tekijänoikeus, nimi ja verkkotunnus siirtyvät organisaatiolle Open Brand Exchange Foundation (perusteilla), kun se on rekisteröity.
Ilmoita haavoittuvuuksista luottamuksellisesti osoitteeseen [email protected]. Tietoturva on yksi neljästä yhdenmukaisuusprofiilista.
Tämä sivusto ei aseta evästeitä, ei käytä seurantaa eikä lataa mitään muilta palvelimilta.
Kehittäjille
Kolme OpenAPI-sopimusta, JSON Schemat, kuvitteellinen testibrändi ja yhdenmukaisuustestit. Go SDK ja obx-työkalu ovat käyttövalmiita, ja mikä tahansa HTTP-asiakas toimii.
$ 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"]
}Usein kysyttyä
Standardi ja ohjelmisto ovat maksuttomia. Jos ylläpidät itse, maksat vain ylläpidosta. Palveluntarjoajalla on omat hintansa, jotka löydät sen sivustolta.
Ei perusasioihin. Portaalin asennus onnistuu yhdellä klikkauksella, eikä ajastettu tuonti verkko-osoitteesta, SFTP-palvelimelta tai säilöstä vaadi koodia. Kehittäjästä on apua, jos haluat liittää PIM- tai ERP-järjestelmäsi suoraan.
Ei. Jokainen brändi pyörittää omaa portaaliaan, halutessaan omalla verkkotunnuksellaan. Ei ole keskitettyä alustaa, joka pitää hallussaan sisältöäsi.
Sinä. Jälleenmyyjät pyytävät pääsyä, ja sinä hyväksyt tai hylkäät jokaisen pyynnön. Valitset myös, mitä brändejä jälleenmyyjä näkee ja saako alkuperäisiä kuvia ladata.
Ota oma portaali käyttöön tai kerro meille järjestelmistäsi ja jälleenmyyjistäsi, ja ole mukana muovaamassa ensimmäistä julkaisua.
Anna palveluntarjoajan hoitaa se, tai ylläpidä sitä itse maksutta yhdellä klikkauksella tai komennolla. Ylläpitovaihtoehdot
Yksi CSV-tiedosto ja kiinteästi nimetyt kuvat. PIM, ERP tai tavallinen kansio toimittaa ne joka yö ilman käsityötä. Automaatio
Jälleenmyyjät kirjautuvat, liittävät EAN-luettelonsa ja lataavat. Heidän järjestelmänsä hakevat saman sisällön vakio-APIn kautta. Jälleenmyyjille