Koristite podatke Atlasa.

Brzi početak

Postavite osnovni URL jednom, a zatim pokrenite bilo koji primjer dolje.

ATLAS_API=https://www.elabel-atlas.eu/api/v1

Autentikacija

Anonimni zahtjevi mogu koristiti svaki javni endpoint za čitanje. Ključ podiže ograničenje brzine i potreban je za operacije pisanja pružatelja. Vlasnici i administratori radnih prostora pružatelja mogu izraditi ključ u prijavljenom radnom prostoru pod API ključevi. Ako Vam treba ključ za čitanje bez radnog prostora pružatelja ili skupni pristup, pišite na david@essentialcode.eu.

curl --fail --silent --show-error \
  -H "Authorization: Bearer $ATLAS_API_KEY" \
  "$ATLAS_API/public-records?limit=1"

Ograničenja brzine

Svaka javna operacija dopušta 60 anonimnih zahtjeva u minuti po adresi ili 600 u minuti po ključu za čitanje. Odgovori uključuju zaglavlja limit, remaining i reset. Zahtjev iznad ograničenja vraća HTTP 429:

HTTP/1.1 429 Too Many Requests
retry-after: 60
x-ratelimit-limit: 60
x-ratelimit-remaining: 0

{"error":{"code":"rate_limited","message":"The public API rate limit was exceeded."}}

Javni endpointi za čitanje

curl --fail --silent --show-error \
  "$ATLAS_API/search?q=Veltliner&limit=1"

{
  "query": "Veltliner",
  "records": [{
    "atlas_record_id": "QXSvIVqvHcRW-LjHtG88I",
    "name": "Grüner Veltliner 2025",
    "provider": { "name": "Demo Wine Cooperative" },
    "gtin": "4006381333931"
  }]
}

curl --fail --silent --show-error \
  "$ATLAS_API/public-records?limit=1"

{
  "records": [{
    "atlas_record_id": "ovPcoHyHMEbzdcGC_Zkm_",
    "name": "Grüner Veltliner Ried Steinberg 2024",
    "provider": { "name": "Glasswise" }
  }],
  "next_cursor": "eyJ1cGRhdGVkQXQiOjE3ODk1MDIxMjQ3MDcsImlkIjoib3ZQY29IeUhNRWJ6ZGNHQ19aa21fIn0"
}

curl --fail --silent --show-error \
  "$ATLAS_API/public-records/4006381333931"

{
  "gtin": "4006381333931",
  "records": [{
    "atlas_record_id": "QXSvIVqvHcRW-LjHtG88I",
    "name": "Grüner Veltliner 2025",
    "provider": { "name": "Demo Wine Cooperative" }
  }]
}

RECORD_ID=$(curl --fail --silent --show-error \
  "$ATLAS_API/public-records?limit=1" | jq -r '.records[0].atlas_record_id')
curl --fail --silent --show-error \
  "$ATLAS_API/public-records/by-id/$RECORD_ID"

{
  "atlas_record_id": "ovPcoHyHMEbzdcGC_Zkm_",
  "name": "Grüner Veltliner Ried Steinberg 2024",
  "provider": { "name": "Glasswise" },
  "atlas_updated_at": "2026-09-15T19:55:24.707Z"
}

Paginacija

Javni popis zapisa vraća next_cursor kada postoji sljedeća stranica. Pošaljite tu točnu neprozirnu vrijednost s istim filtrima. Nemojte je dekodirati niti mijenjati.

CURSOR=$(curl --fail --silent --show-error \
  "$ATLAS_API/public-records?limit=1" | jq -r '.next_cursor')
curl --fail --silent --show-error \
  "$ATLAS_API/public-records?limit=1&cursor=$CURSOR"

Jezici javnih zapisa

Stranice javnih zapisa lokaliziraju samo Atlasove oznake i kodove koje definira E-Label Standard Format, uključujući vrstu vina, svojstva vina, kodove država, ključeve nutricije i jedinice. Svaki tekst koji je napisao pružatelj ostaje točno kako je dostavljen, uključujući nazive i kategorije sastojaka te svaki tekst o pakiranju ili zbrinjavanju koji je pružatelj napisao.

Prvi kod u languages uvijek je primarni jezik zapisa, uključujući kada Atlas ne može prikazati svoje sučelje na tom jeziku. Stranica nudi primarni sadržaj i podržane jezike koji imaju pružateljeve prijevode. Povežite na odabir s ?lang=de ili ?lang=hr. Bez parametra Atlas koristi Accept-Language kada postoji odgovarajući sadržaj i preusmjerava na odgovarajući URL za dijeljenje.

Preferirajte strukturirane ingredients[] kako biste sačuvali oznake alergena i ekološkog podrijetla. Koristite ingredients_text samo kada pružatelj ima potpunu deklaraciju u prozi. Pružatelji mogu dodati vrijednosti translations.{language} za ingredients_text, designation_of_origin i svaku uputu packaging[].disposal. Polje packaging prati duljinu i redoslijed primarne liste; koristite null za uputu koja treba pasti na primarnu vrijednost. Nedostajući prijevodi padaju na primarnu vrijednost najviše razine. REST i MCP vraćaju ovu neobaveznu mapu, a JSON-LD koristi vrijednosti označene jezikom. Ova mapa koju isporučuje pružatelj jedini je način na koji se tekst pružatelja mijenja između jezika.

Tijelo zahtjeva pružatelja slijedi E-Label Standard Format.

Na javnim stranicama Atlas prikazuje vlastite kodove Standarda (productType, color, sweetness, packagingGas, packagingType, materialType i collection) na jeziku stranice iz objavljenog vokabulara Standarda. Svaka druga vrijednost pružatelja ostaje točno kako je dostavljena.

MCP

Model Context Protocol, ili MCP, standardan je način da AI klijent poziva vanjske alate. e-label Atlas pruža anonimni Streamable HTTP poslužitelj na https://www.elabel-atlas.eu/mcp.

Poslužitelj izlaže search_elabels, lookup_elabel_by_gtin, get_elabel i list_elabels_updated_since.

Instalirajte Atlas u agenta

Odaberite svog klijenta. Claude Code plugin i Codex postavke uključuju i Atlasove smjernice za skill i MCP alate uživo. Ostali klijenti povezuju se na isti MCP poslužitelj samo za čitanje.

claude plugin marketplace add https://www.elabel-atlas.eu/claude/marketplace.json && \
  claude plugin install elabel-atlas@elabel-atlas

https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=e-label%20Atlas&connectorUrl=https%3A%2F%2Fwww.elabel-atlas.eu%2Fmcp

mkdir -p "$HOME/.agents/skills/elabel-atlas"
curl --fail --location   https://www.elabel-atlas.eu/api/v1/SKILL.md   --output "$HOME/.agents/skills/elabel-atlas/SKILL.md"
codex mcp add elabel-atlas --url https://www.elabel-atlas.eu/mcp

{
  "mcpServers": {
    "elabel-atlas": {
      "url": "https://www.elabel-atlas.eu/mcp"
    }
  }
}

{
  "mcpServers": {
    "elabel-atlas": {
      "httpUrl": "https://www.elabel-atlas.eu/mcp"
    }
  }
}