Kasuta Atlase andmeid.

Kiirstart

Määra baas-URL üks kord ja käivita siis ükskõik milline allolev näide.

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

Autentimine

Anonüümsed päringud saavad kasutada iga avalikku lugemislõppu. Võti tõstab päringulimiiti ja on kohustuslik pakkujate kirjutustoimingute jaoks. Pakkujate tööruumide omanikud ja administraatorid saavad võtme luua sisselogitud tööruumis jaotises API võtmed. Kui vajad lugejavõtit ilma pakkuja tööruumita või massilist ligipääsu, kirjuta aadressile david@essentialcode.eu.

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

Päringulimiidid

Iga avalik toiming lubab 60 anonüümset päringut minutis aadressi kohta või 600 minutis lugejavõtme kohta. Vastused sisaldavad päiseid limit, remaining ja reset. Limiidist üle minev päring tagastab 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."}}

Avalikud lugemislõpud

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

Lehekülgedeks jaotamine

Avalike kirjete loend tagastab väärtuse next_cursor, kui järgmine lehekülg on olemas. Saada see täpne läbipaistmatu väärtus samade filtritega. Ära dekodeeri ega muuda seda.

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"

Avalike kirjete keeled

Avalike kirjete leheküljed lokaliseerivad ainult Atlase enda sildid ja E-Label Standard Formatis defineeritud koodid, sealhulgas veinitüüp, veini omadused, riigikoodid, toiteväärtuse võtmed ja ühikud. Iga pakkujate kirjutatud tekst jääb täpselt selliseks, nagu see tarniti, sealhulgas koostisosade nimed ja kategooriad ning iga pakkujate kirjutatud pakendi või hävitamise tekst.

Esimene kood languages loendis on alati kirje põhikeel, ka siis kui Atlas ei saa oma liidest selles keeles renderdada. Lehekülg pakub põhisisu ja toetatud keeli, millel on pakkujate tõlked. Lingi valikusse ?lang=de või ?lang=hr kaudu. Ilma parameetrita kasutab Atlas Accept-Language'i, kui leidub sobiv sisu, ja suunab õigele jagatavale URLile.

Eelista struktureeritud ingredients[] väärtusi, et allergeeni- ja ökomärgised säiliksid. Kasuta ingredients_text ainult siis, kui pakkujal on täielik proosadeklaratsioon. Pakkujad võivad lisada translations.{language} väärtusi väljadele ingredients_text, designation_of_origin ja igale packaging[].disposal juhendile. Packaging massiiv järgib põhilisti pikkust ja järjekorda; kasuta null juhendi jaoks, mis peaks põhiväärtusele tagasi langema. Puuduvad tõlked langevad tipptaseme põhiväärtusele. REST ja MCP tagastavad selle valikulise kaardi ja JSON-LD kasutab keelega märgistatud väärtusi. See pakkujate tarnitud kaart on ainus viis, kuidas pakkujate tekst keelte vahel muutub.

Pakkuja päringu keha järgib E-Label Standard Formatit.

Avalikel lehekülgedel renderdab Atlas oma Standardi koodid (productType, color, sweetness, packagingGas, packagingType, materialType ja collection) lehekülje keeles Standardi avaldatud sõnavarast. Iga muu pakkuja väärtus jääb täpselt selliseks, nagu see tarniti.

MCP

Model Context Protocol ehk MCP on standardne viis, kuidas AI klient väliseid tööriistu kutsub. e-label Atlas pakub anonüümset Streamable HTTP serverit aadressil https://www.elabel-atlas.eu/mcp.

Server pakub search_elabels, lookup_elabel_by_gtin, get_elabel ja list_elabels_updated_since.

Installi Atlas agenti

Vali oma klient. Claude Code plugin ja Codexi seadistus sisaldavad nii Atlase skilli juhendit kui ka töötavaid MCP tööriistu. Teised kliendid ühenduvad samasse kirjutuskaitstud MCP serverisse.

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