Brug Atlas-data.

Hurtig start

Angiv basis-URL'en én gang, og kør derefter ethvert eksempel nedenfor.

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

Autentificering

Anonyme forespørgsler kan bruge ethvert offentligt læseendpoint. En nøgle hæver forespørgselsgrænsen og er påkrævet til udbyderskriveoperationer. Ejere og administratorer af udbyderarbejdsområder kan oprette en nøgle i det loggede arbejdsområde under API-nøgler. Hvis du har brug for en læsenøgle uden et udbyderarbejdsområde eller bulkadgang, skriv til david@essentialcode.eu.

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

Forespørgselsgrænser

Hver offentlig operation tillader 60 anonyme forespørgsler pr. minut pr. adresse eller 600 pr. minut pr. læsenøgle. Svar indeholder headere for limit, remaining og reset. En forespørgsel over grænsen returnerer 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."}}

Offentlige læseendpoints

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 offentlige postliste returnerer next_cursor, når der findes en næste side. Send den nøjagtige uigennemsigtige værdi med de samme filtre. Afkod eller rediger den ikke.

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"

Offentlige postsprog

Offentlige postsider lokaliserer kun Atlas' egne etiketter og koder defineret i E-Label Standard Format, herunder vintype, vinegenskaber, landekoder, næringsnøgler og enheder. Enhver tekst skrevet af udbyderen forbliver præcis som leveret, herunder ingrediensnavne og -kategorier samt enhver emballage- eller bortskaffelsestekst, som udbyderen har skrevet.

Den første kode i languages er altid postens primære sprog, også når Atlas ikke kan gengive sin grænseflade på det sprog. Siden tilbyder det primære indhold og understøttede sprog, der har udbyderoversættelser. Link til valget via ?lang=de eller ?lang=hr. Uden parameteren bruger Atlas Accept-Language, når der findes matchende indhold, og omdirigerer til den rette delbare URL.

Foretræk strukturerede ingredients[], så allergen- og økologiflag bevares. Brug kun ingredients_text, når udbyderen har en komplet prosaerklæring. Udbydere kan tilføje translations.{language}-værdier for ingredients_text, designation_of_origin og hver packaging[].disposal-instruktion. Packaging-arrayet følger primærlistens længde og rækkefølge; brug null for en instruktion, der skal falde tilbage til den primære værdi. Manglende oversættelser falder tilbage til den primære værdi på øverste niveau. REST og MCP returnerer dette valgfrie kort, og JSON-LD bruger de sprogmærkede værdier. Dette udbyderleverede kort er den eneste måde, udbydertekst ændrer sig mellem sprog.

Udbyderens forespørgselsbody følger E-Label Standard Format.

På offentlige sider gengiver Atlas sine egne Standard-koder (productType, color, sweetness, packagingGas, packagingType, materialType og collection) på sidens sprog fra Standardens publicerede ordforråd. Enhver anden udbyderværdi forbliver præcis som leveret.

MCP

Model Context Protocol, eller MCP, er standardmåden, en AI-klient kalder eksterne værktøjer på. e-label Atlas tilbyder en anonym Streamable HTTP-server på https://www.elabel-atlas.eu/mcp.

Serveren eksponerer search_elabels, lookup_elabel_by_gtin, get_elabel og list_elabels_updated_since.

Installér Atlas i en agent

Vælg din klient. Claude Code-plugin'et og Codex-opsætningen indeholder både Atlas-skill-vejledningen og levende MCP-værktøjer. Andre klienter forbinder til den samme skrivebeskyttede 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"
    }
  }
}