Brand.dev oskus

Too brändiandmed brand.dev API-st ja salvesta logod kohalikult serveerimiseks.

Samm 1: Saa domeen

Eralda sihtdomeen kasutaja sisendist. Eemalda protokoll ja lõpus olevad kaldkriipsud (nt „https://example.com/“ → „example.com“).

Samm 2: Too brändiinfo

# BRANDDEV_API_KEY must be set in your environment
curl -s "https://api.brand.dev/v1/brand/retrieve?domain=${DOMAIN}" \
  -H "Authorization: Bearer ${BRANDDEV_API_KEY}" \
  -H "Content-Type: application/json"

Eralda vastusest: - Brändi nimi (.brand.title või .brand.name) - Kirjeldus (.brand.description) - Logo URL-id (.brand.logos[] seast) — eelista ikooni/ruudukujulisi logosid kaardipaigutusteks, täislogosid päisteks - Tööstusharu/kategooria, kui saadaval

Samm 3: Laadi logod kohalikult alla

LAADI logod ALATI kohalikult alla serveerimiseks. Ära kunagi viita tootmiskoodis välistele media.brand.dev URL-idele — need võivad muutuda või kaduda.

Kuhu salvestada

Salvestuskoht sõltub projektist. Otsi olemasolevaid mustreid: - Next.js / staatilised saidid: public/logos/<context>/ (serveeritakse kui /logos/<context>/) - Muud veebiprojektid: otsi olemasolevaid static/, assets/, images/ või public/ katalooge - Kui konventsiooni pole: loo logos/ kataloog projekti staatiliste varade juure alla

Nimekonventsioon

<brand-slug>.<ext>, kus:
<brand-slug> on väiketäheline brändinimi, tühikud asendatud sidekriipsudega (nt miss-a, mitte miss_a)
<ext> vastab algsele faililaiendile (png, webp, jpg, svg)
Soovi korral grupeeri konteksti alamkataloogi järgi (nt partners/, customers/), kui projektis on mitu logokogumit

Allalaadimiskäsk

mkdir -p <logo-dir>
curl -sL "<logo-url>" -o "<logo-dir>/<brand-slug>.<ext>"

Allalaadimise kontroll

ls -la <logo-dir>/<brand-slug>.<ext>

Samm 4: Tagasta tulemused

Anna kasutajale: - Brändi nimi - Kirjeldus - Tööstusharu - Kohalik logo tee — tee, mida koodis kasutada (suhteline projekti staatilise juure suhtes) - Algne allika URL (ainult viiteks)

Olulised reeglid

Salvesta pildid alati kohalikult — ära kasuta media.brand.dev URL-e otse tootmiskoodis.
Kasuta koodis kohalikke teid — viita suhteliselt projekti staatiliste varade serveerimisjuure suhtes.
Eelista ruudu-/ikoonlogosid kaardipaigutusteks (sobivad ruudustikukaartidesse paremini).
Eelista täis-/horisontaalseid logosid päistele ja hero-sektsioonidele.
Kui brändil API vastuses logosid pole, märgi see ja soovita varuikooni.

Brändiinfo