Käytä Atlas-tietoja.

Pika-aloitus

Aseta perus-URL kerran ja aja sitten mikä tahansa alla oleva esimerkki.

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

Todennus

Anonyymit pyynnöt voivat käyttää jokaista julkista lukupäätepistettä. Avain nostaa pyyntörajaa ja vaaditaan tarjoajien kirjoitusoperaatioihin. Tarjoajatyötilojen omistajat ja ylläpitäjät voivat luoda avaimen kirjautuneen työtilan API-avaimet-osiossa. Jos tarvitset lukuavaimen ilman tarjoajatyötilaa tai massakäyttöoikeuden, kirjoita osoitteeseen david@essentialcode.eu.

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

Pyyntörajat

Jokainen julkinen operaatio sallii 60 anonyymiä pyyntöä minuutissa osoitetta kohden tai 600 minuutissa lukuavainta kohden. Vastaukset sisältävät limit-, remaining- ja reset-otsakkeet. Rajan ylittävä pyyntö palauttaa 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."}}

Julkiset lukupäätepisteet

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

Sivutus

Julkinen tietuelista palauttaa next_cursor-arvon, kun seuraava sivu on olemassa. Lähetä tämä tarkka läpinäkymätön arvo samoilla suodattimilla. Älä dekoodaa tai muokkaa sitä.

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"

Julkisten tietueiden kielet

Julkisten tietueiden sivut lokalisovat vain Atlaksen omat nimikkeet ja E-Label Standard Formatissa määritellyt koodit, mukaan lukien viinityyppi, viinin ominaisuudet, maakoodit, ravintoarvoavaimet ja yksiköt. Jokainen tarjoajan kirjoittama teksti säilyy täsmälleen sellaisena kuin se toimitettiin, mukaan lukien ainesosien nimet ja kategoriat sekä kaikki tarjoajan kirjoittamat pakkaus- tai hävitystekstit.

Ensimmäinen koodi languages-kentässä on aina tietueen ensisijainen kieli, myös silloin kun Atlas ei voi renderöidä käyttöliittymäänsä sillä kielellä. Sivu tarjoaa ensisijaisen sisällön ja tuetut kielet, joilla on tarjoajan käännöksiä. Linkitä valintaan ?lang=de- tai ?lang=hr-parametrilla. Ilman parametria Atlas käyttää Accept-Languagea, kun osuvaa sisältöä on, ja ohjaa oikeaan jaettavaan URL:iin.

Suosi rakenteisia ingredients[]-arvoja, jotta allergeeni- ja luomumerkinnät säilyvät. Käytä ingredients_text-kenttää vain, kun tarjoajalla on täydellinen proosamuotoinen ilmoitus. Tarjoajat voivat lisätä translations.{language}-arvoja kentille ingredients_text, designation_of_origin ja jokaiselle packaging[].disposal-ohjeelle. Packaging-taulukko seuraa ensisijaisen listan pituutta ja järjestystä; käytä null ohjeelle, joka palautuu ensisijaiseen arvoon. Puuttuvat käännökset palautuvat ylimmän tason ensisijaiseen arvoon. REST ja MCP palauttavat tämän valinnaisen kartan, ja JSON-LD käyttää kielitunnisteisia arvoja. Tämä tarjoajan toimittama kartta on ainoa tapa, jolla tarjoajan teksti vaihtuu kielten välillä.

Tarjoajan pyynnön runko noudattaa E-Label Standard Formatia.

Julkisilla sivuilla Atlas renderöi omat Standard-koodinsa (productType, color, sweetness, packagingGas, packagingType, materialType ja collection) sivun kielellä Standardin julkaistusta sanastosta. Jokainen muu tarjoajan arvo säilyy täsmälleen sellaisena kuin toimitettiin.

MCP

Model Context Protocol eli MCP on standardi tapa, jolla AI-asiakas kutsuu ulkoisia työkaluja. e-label Atlas tarjoaa anonyymin Streamable HTTP -palvelimen osoitteessa https://www.elabel-atlas.eu/mcp.

Palvelin tarjoaa search_elabels, lookup_elabel_by_gtin, get_elabel ja list_elabels_updated_since.

Asenna Atlas agenttiin

Valitse asiakkaasi. Claude Code -laajennus ja Codex-asennus sisältävät sekä Atlas-skill-ohjeen että toimivat MCP-työkalut. Muut asiakkaat yhdistävät samaan vain luku -MCP-palvelimeen.

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