Lietojiet Atlas datus.

Ātrā sākšana

Iestatiet bāzes URL vienreiz un pēc tam palaidiet jebkuru no zemāk esošajiem piemēriem.

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

Autentifikācija

Anonīmi vaicājumi var lietot katru publisko lasīšanas galapunktu. Atslēga paaugstina vaicājumu limitu un ir obligāta piegādātāju rakstīšanas operācijām. Piegādātāju darba telpu īpašnieki un administratori var izveidot atslēgu pieteiktajā darba telpā sadaļā API atslēgas. Ja jums vajag lasīšanas atslēgu bez piegādātāja darba telpas vai masveida piekļuvi, rakstiet uz david@essentialcode.eu.

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

Vaicājumu limiti

Katra publiskā operācija atļauj 60 anonīmus vaicājumus minūtē uz adresi vai 600 minūtē uz lasīšanas atslēgu. Atbildes ietver limit, remaining un reset galvenes. Vaicājums virs limita atgriež 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."}}

Publiskie lasīšanas galapunkti

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

Lapu sadalīšana

Publiskais ierakstu saraksts atgriež next_cursor, kad pastāv nākamā lapa. Nosūtiet šo precīzo necaurspīdīgo vērtību ar tādiem pašiem filtriem. Nedekodējiet un ne labojiet to.

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"

Publisko ierakstu valodas

Publisko ierakstu lapas lokalizē tikai Atlas paša apzīmējumus un E-Label Standard Format definētos kodus, tostarp vīna veidu, vīna īpašības, valstu kodus, uzturvērtības atslēgas un vienības. Katrs piegādātāja rakstīts teksts paliek tieši tāds, kā piegādāts, tostarp sastāvdaļu nosaukumi un kategorijas un jebkurš piegādātāja rakstīts iepakojuma vai utilizācijas teksts.

Pirmais kods languages ir vienmēr ieraksta primārā valoda, arī tad, kad Atlas nevar attēlot savu saskarni šajā valodā. Lapa piedāvā primāro saturu un atbalstītās valodas ar piegādātāja tulkojumiem. Saitējiet uz izvēli caur ?lang=de vai ?lang=hr. Bez parametra Atlas izmanto Accept-Language, kad pastāv atbilstošs saturs, un pāradresē uz pareizo kopīgojamo URL.

Dodot priekšroku strukturētām ingredients[], lai saglabātu alergēnu un bio karodziņus. Izmantojiet ingredients_text tikai tad, kad piegādātājam ir pilna deklarācija prozā. Piegādātāji var pievienot translations.{language} vērtības ingredients_text, designation_of_origin un katram packaging[].disposal norādījumam. Packaging masīvs seko primārā saraksta garumam un secībai; izmantojiet null norādījumam, kuram jākrīt uz primāro vērtību. Trūkstošie tulkojumi krīt uz augstākā līmeņa primāro vērtību. REST un MCP atgriež šo neobligāto karti, un JSON-LD izmanto ar valodu atzīmētās vērtības. Šī piegādātāja piegādātā karte ir vienīgais veids, kā piegādātāja teksts mainās starp valodām.

Piegādātāja vaicājuma ķermenis seko E-Label Standard Format.

Publiskajās lapās Atlas attēlo savus Standarta kodus (productType, color, sweetness, packagingGas, packagingType, materialType un collection) lapas valodā no Standarta publicētā vārdnīcas. Katra cita piegādātāja vērtība paliek tieši tāda, kā piegādāta.

MCP

Model Context Protocol jeb MCP ir standarta veids, kā AI klients izsauc ārējos rīkus. e-label Atlas piedāvā anonīmu Streamable HTTP serveri https://www.elabel-atlas.eu/mcp.

Serveris atklāj search_elabels, lookup_elabel_by_gtin, get_elabel un list_elabels_updated_since.

Instalējiet Atlas aģentā

Izvēlieties savu klientu. Claude Code spraudnis un Codex iestatījums ietver gan Atlas skill vadlīnijas, gan dzīvus MCP rīkus. Citi klienti pieslēdzas tam pašam tikai lasāmajam MCP serverim.

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