Åben standard · Gratis software
Open Brand Exchange er en åben standard for, hvordan forhandlere henter produktfotos og varedata fra et brand: i en portal i browseren, som zip eller regneark eller direkte ind i deres eget system via ét API. Hvordan indholdet kommer ind i din portal, bestemmer du selv.
{
"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
}Sådan virker det
Dit indhold ligger i din egen portal. Indkøbere søger og downloader filer i browseren, og deres software læser det samme indhold via API'et.
01 Portal
Indkøbere logger ind på din portal, indsætter EAN-numrene fra deres ordre og downloader præcis det, de skal bruge: ét foto, én vare eller en zip med et helt udvalg.
02 API
Forhandlernes software henter alt én gang og derefter kun ændringerne, også det, du trækker tilbage. Hvert billede kommer med brugsrettigheder, embargodato og AI-oprindelse.
{
"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 Dine systemer
Standarden handler om, hvordan forhandlere henter indhold. Hvordan dit indhold kommer ind i portalen, vælger du selv: en natlig import fra en webadresse, SFTP eller S3, en eksportmappe eller kommandolinjeværktøjet 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: exportHvem det er til
Slut med at sende filer rundt. Forhandlerne henter selv det, de skal bruge, og du bestemmer, hvem der får hvad.
Alle brands i ét ensartet format, i browseren eller direkte i din software.
Hosting
Tre udgaver af den samme portal. De består de samme konformitetstests og taler det samme API, så du kan skifte mellem dem.
Styring
Open Brand Exchange skal tilhøre de brands, forhandlere og softwareleverandører, der bruger den, ikke ét firma.
Version 0.1, skrevet i OpenAPI 3.1 og JSON Schema under CC-BY-4.0. Alle må implementere den, også kommercielt.
61 automatiske tests i fire profiler. Alle implementeringer testes på samme måde.
SDK'et, obx-værktøjet og webgrænsefladen er Apache-2.0. De tre portaludgaver er AGPL-3.0, så forbedringer forbliver åbne.
Ophavsretten, navnet og domænet overgår til Open Brand Exchange Foundation (under stiftelse), når den er registreret.
Rapportér sårbarheder fortroligt til [email protected]. Sikkerhed er en af de fire konformitetsprofiler.
Dette websted sætter ingen cookies, bruger ingen trackere og henter intet fra andre servere.
Udviklere
Tre OpenAPI-kontrakter, JSON Schemas, et fiktivt testbrand og konformitetstests. Go SDK og obx-værktøjet er klar til brug, og enhver HTTP-klient virker.
$ 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"]
}Ofte stillede spørgsmål
Standarden og softwaren er gratis. Hoster du selv, betaler du kun for hosting. En udbyder har sine egne priser, som du finder på udbyderens websted.
Ikke til det grundlæggende. En portal installeres med ét klik, og en planlagt import fra en webadresse, SFTP-server eller bucket kræver ingen kode. En udvikler er en hjælp, hvis du vil koble dit PIM eller ERP direkte på.
Nej. Hvert brand driver sin egen portal, på sit eget domæne, hvis det vil. Der er ingen central platform, der ligger inde med dit indhold.
Det gør du. Forhandlere anmoder om adgang, og du godkender eller afviser hver anmodning. Du vælger også, hvilke brands en forhandler ser, og om originaler må downloades.
Sæt din egen portal op, eller fortæl os om dine systemer og forhandlere, og vær med til at forme den første udgivelse.
Lad en udbyder drive den, eller host den selv gratis med ét klik eller én kommando. Hostingmuligheder
Én CSV-fil og billeder med et fast navn. Dit PIM, ERP eller en almindelig mappe leverer dem hver nat, uden manuelt arbejde. Automatisering
Forhandlere logger ind, indsætter deres EAN-liste og downloader. Deres software henter det samme indhold via standard-API'et. For forhandlere