Používajte údaje Atlas.

Rýchly štart

Nastavte základnú URL raz a potom spustite ľubovoľný príklad nižšie.

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

Autentifikácia

Anonymné požiadavky môžu používať každý verejný čítací endpoint. Kľúč zvyšuje limit požiadaviek a je vyžadovaný pre zapisovacie operácie poskytovateľov. Vlastníci a administrátori pracovných priestorov poskytovateľov môžu kľúč vytvoriť v prihlásenom pracovnom priestore pod API kľúče. Ak potrebujete čítací kľúč bez pracovného priestoru poskytovateľa alebo hromadný prístup, napíšte na david@essentialcode.eu.

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

Limity požiadaviek

Každá verejná operácia povoľuje 60 anonymných požiadaviek za minútu na adresu alebo 600 za minútu na čítací kľúč. Odpovede obsahujú hlavičky limit, remaining a reset. Požiadavka nad limitom vracia 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."}}

Verejné čítacie endpointy

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

Stránkovanie

Verejný zoznam záznamov vracia next_cursor, ak existuje ďalšia stránka. Pošlite túto presnú nepriehľadnú hodnotu s rovnakými filtrami. Nedekódujte ju ani neupravujte.

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"

Jazyky verejných záznamov

Stránky verejných záznamov lokalizujú iba vlastné popisky Atlasu a kódy definované v E-Label Standard Format, vrátane typu vína, vlastností vína, kódov krajín, nutričných kľúčov a jednotiek. Každý text napísaný poskytovateľom zostáva presne tak, ako bol dodaný, vrátane názvov a kategórií zložiek a každého textu o balení či likvidácii, ktorý poskytovateľ napísal.

Prvý kód v languages je vždy primárny jazyk záznamu, vrátane prípadov, keď Atlas nemôže svoje rozhranie v tomto jazyku vykresliť. Stránka ponúka primárny obsah a podporované jazyky, ktoré majú preklady poskytovateľa. Odkazujte na výber pomocou ?lang=de alebo ?lang=hr. Bez parametra používa Atlas Accept-Language, keď existuje zodpovedajúci obsah, a presmeruje na zodpovedajúcu zdieľateľnú URL.

Preferujte štruktúrované ingredients[], aby sa zachovali príznaky alergénov a bio. ingredients_text používajte len vtedy, keď má poskytovateľ úplnú deklaráciu v próze. Poskytovatelia môžu pridať hodnoty translations.{language} pre ingredients_text, designation_of_origin a každú inštrukciu packaging[].disposal. Pole packaging sa riadi dĺžkou a poradím primárneho zoznamu; pre inštrukciu, ktorá má spadnúť na primárnu hodnotu, použite null. Chýbajúce preklady padajú na primárnu hodnotu najvyššej úrovne. REST aj MCP vracajú túto voliteľnú mapu a JSON-LD používa hodnoty označené jazykom. Táto mapa dodávaná poskytovateľom je jediný spôsob, ako sa text poskytovateľa mení medzi jazykmi.

Telo požiadavky poskytovateľa sa riadi E-Label Standard Format.

Na verejných stránkach vykresľuje Atlas vlastné kódy Štandardu (productType, color, sweetness, packagingGas, packagingType, materialType a collection) v jazyku stránky z publikovaného slovníka Štandardu. Každá iná hodnota poskytovateľa zostáva presne tak, ako bola dodaná.

MCP

Model Context Protocol, alebo MCP, je štandardný spôsob, ako AI klient volá externé nástroje. e-label Atlas poskytuje anonymný Streamable HTTP server na https://www.elabel-atlas.eu/mcp.

Server vystavuje search_elabels, lookup_elabel_by_gtin, get_elabel a list_elabels_updated_since.

Nainštalujte Atlas do agenta

Vyberte si klienta. Plugin Claude Code a nastavenie Codex obsahujú aj vodítko skillu Atlas, aj živé MCP nástroje. Ostatní klienti sa pripájajú k rovnakému MCP serveru len na čítanie.

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