Använd Atlas-data.

Snabbstart

Sätt bas-URL:en en gång och kör sedan vilket exempel som helst nedan.

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

Autentisering

Anonyma anrop kan använda varje offentlig läsendpoint. En nyckel höjer anropsgränsen och krävs för leverantörsskrivoperationer. Ägare och administratörer av leverantörsarbetsytor kan skapa en nyckel i den inloggade arbetsytan under API-nycklar. Om du behöver en läsnyckel utan en leverantörsarbetsyta eller bulkåtkomst, skriv till david@essentialcode.eu.

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

Anropsgränser

Varje offentlig operation tillåter 60 anonyma anrop per minut per adress eller 600 per minut per läsnyckel. Svar innehåller headers för limit, remaining och reset. Ett anrop över gränsen returnerar 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."}}

Offentliga läsendpoints

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

Paginering

Den offentliga postlistan returnerar next_cursor när en nästa sida finns. Skicka det exakta ogenomskinliga värdet med samma filter. Avkoda eller redigera det inte.

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"

Offentliga postspråk

Offentliga postsidor lokaliserar bara Atlas egna etiketter och koder definierade i E-Label Standard Format, inklusive vintype, vinegenskaper, landskoder, näringsnycklar och enheter. All text skriven av leverantören förblir exakt som levererad, inklusive ingrediensnamn och -kategorier samt all förpacknings- eller kasseringstext som leverantören skrivit.

Den första koden i languages är alltid postens primära språk, även när Atlas inte kan rendera sitt gränssnitt på det språket. Sidan erbjuder det primära innehållet och stödda språk som har leverantörsöversättningar. Länka till valet via ?lang=de eller ?lang=hr. Utan parametern använder Atlas Accept-Language när matchande innehåll finns och omdirigerar till rätt delningsbar URL.

Föredra strukturerade ingredients[] så att allergen- och ekoflaggorna bevaras. Använd ingredients_text bara när leverantören har en komplett prosadeklaration. Leverantörer kan lägga till translations.{language}-värden för ingredients_text, designation_of_origin och varje packaging[].disposal-instruktion. Packaging-arrayen följer primärlistans längd och ordning; använd null för en instruktion som ska falla tillbaka på primärvärdet. Saknade översättningar faller tillbaka på primärvärdet på toppnivå. REST och MCP returnerar denna valfria karta, och JSON-LD använder de språktaggade värdena. Denna leverantörslevererade karta är det enda sättet leverantörstext ändras mellan språk.

Leverantörens anropsbody följer E-Label Standard Format.

På offentliga sidor renderar Atlas sina egna Standard-koder (productType, color, sweetness, packagingGas, packagingType, materialType och collection) på sidans språk från Standardens publicerade vokabulär. Varje annat leverantörsvärde förblir exakt som levererat.

MCP

Model Context Protocol, eller MCP, är standarden för hur en AI-klient anropar externa verktyg. e-label Atlas erbjuder en anonym Streamable HTTP-server på https://www.elabel-atlas.eu/mcp.

Servern exponerar search_elabels, lookup_elabel_by_gtin, get_elabel och list_elabels_updated_since.

Installera Atlas i en agent

Välj din klient. Claude Code-pluginet och Codex-konfigurationen innehåller både Atlas-skill-vägledningen och levande MCP-verktyg. Andra klienter ansluter till samma skrivskyddade MCP-server.

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