Naudokite Atlas duomenis.

Greita pradžia

Nustatykite bazinį URL vieną kartą, tada paleiskite bet kurį iš žemiau esančių pavyzdžių.

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

Autentifikavimas

Anoniminės užklausos gali naudoti kiekvieną viešąjį skaitymo galinį tašką. Raktas padidina užklausų limitą ir yra būtinas tiekėjų rašymo operacijoms. Tiekėjų darbo sričių savininkai ir administratoriai gali sukurti raktą prisijungusioje darbo srityje, skiltyje API raktai. Jei jums reikia skaitymo rakto be tiekėjo darbo srities arba masinio prieigos, rašykite į david@essentialcode.eu.

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

Užklausų limitai

Kiekviena viešoji operacija leidžia 60 anoniminių užklausų per minutę vienam adresui arba 600 per minutę vienam skaitymo raktui. Atsakymai turi limit, remaining ir reset antraštes. Užklausa viršijanti limitą grąžina 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."}}

Viešieji skaitymo galiniai taškai

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

Puslapiavimas

Viešasis įrašų sąrašas grąžina next_cursor, kai egzistuoja kitas puslapis. Siųskite šią tikslią nepermatomą reikšmę su tais pačiais filtrais. Nedekoduokite ir neredaguokite jos.

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"

Viešųjų įrašų kalbos

Viešųjų įrašų puslapiai lokalizuoja tik Atlas pačio žymenis ir E-Label Standard Format apibrėžtus kodus, įskaitant vyno tipą, vyno savybes, šalių kodus, maistinių vertybių raktus ir vienetus. Kiekvienas tiekėjo parašytas tekstas lieka tiksliai toks, kaip pateiktas, įskaitant ingredientų pavadinimus ir kategorijas bei bet kokį tiekėjo parašytą pakuotės ar utilizavimo tekstą.

Pirmasis kodas languages visada yra pagrindinė įrašo kalba, net kai Atlas negali atvaizduoti savo sąsajos ta kalba. Puslapis siūlo pagrindinį turinį ir palaikomas kalbas, turinčias tiekėjo vertimus. Nuoroda į pasirinkimą per ?lang=de arba ?lang=hr. Be parametro Atlas naudoja Accept-Language, kai egzistuoja atitinkantis turinys, ir nukreipia į tinkamą bendrinamą URL.

Teikite pirmenybę struktūrizuotiems ingredients[], kad išliktų alergenų ir ekologiniai požymiai. Naudokite ingredients_text tik tada, kai tiekėjas turi pilną deklaraciją proza. Tiekėjai gali pridėti translations.{language} reikšmes ingredients_text, designation_of_origin ir kiekvienam packaging[].disposal nurodymui. Packaging masyvas seka pagrindinio sąrašo ilgį ir tvarką; naudokite null nurodymui, kuris turi grįžti į pagrindinę reikšmę. Trūkstami vertimai grįžta į aukščiausio lygio pagrindinę reikšmę. REST ir MCP grąžina šį neprivalomą žemėlapį, o JSON-LD naudoja kalba pažymėtas reikšmes. Šis tiekėjo pateiktas žemėlapis yra vienintelis būdas, kaip tiekėjo tekstas keičiasi tarp kalbų.

Tiekėjo užklausos turinys seka E-Label Standard Format.

Viešuosiuose puslapiuose Atlas atvaizduoja savo Standarto kodus (productType, color, sweetness, packagingGas, packagingType, materialType ir collection) puslapio kalba iš Standarto publikuoto žodyno. Kiekviena kita tiekėjo reikšmė lieka tiksliai tokia, kaip pateikta.

MCP

Model Context Protocol arba MCP yra standartinis būdas, kaip AI klientas iškviečia išorinius įrankius. e-label Atlas siūlo anoniminį Streamable HTTP serverį adresu https://www.elabel-atlas.eu/mcp.

Serveris atidengia search_elabels, lookup_elabel_by_gtin, get_elabel ir list_elabels_updated_since.

Įdiekite Atlas į agentą

Pasirinkite savo klientą. Claude Code papildinys ir Codex sąranka apima ir Atlas skill nurodymus, ir gyvus MCP įrankius. Kiti klientai jungiasi prie to paties tik skaitomo MCP serverio.

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