Folosește datele Atlas.

Pornire rapidă

Setează URL-ul de bază o dată, apoi rulează oricare dintre exemplele de mai jos.

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

Autentificare

Solicitările anonime pot folosi fiecare endpoint public de citire. O cheie crește limita de solicitări și este necesară pentru operațiunile de scriere ale furnizorilor. Proprietarii și administratorii spațiilor de lucru ale furnizorilor pot crea o cheie în spațiul de lucru autentificat, la Chei API. Dacă ai nevoie de o cheie de citire fără un spațiu de lucru de furnizor sau de acces în masă, scrie la david@essentialcode.eu.

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

Limite de solicitări

Fiecare operațiune publică permite 60 de solicitări anonime pe minut per adresă sau 600 pe minut per cheie de citire. Răspunsurile includ anteturile limit, remaining și reset. O solicitare peste limită returnează 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."}}

Endpointuri publice de citire

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

Paginare

Lista publică de înregistrări returnează next_cursor când există o altă pagină. Trimite această valoare opacă exactă cu aceleași filtre. Nu o decoda sau edita.

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"

Limbi ale înregistrărilor publice

Paginile de înregistrări publice localizează doar propriile etichete Atlas și codurile definite în E-Label Standard Format, inclusiv tipul de vin, proprietățile vinului, codurile de țară, cheile de valori nutriționale și unitățile. Orice text scris de furnizor rămâne exact cum a fost furnizat, inclusiv denumirile și categoriile de ingrediente și orice text de ambalare sau eliminare scris de furnizor.

Primul cod din languages este întotdeauna limba principală a înregistrării, chiar și atunci când Atlas nu își poate afișa interfața în acea limbă. Pagina oferă conținutul principal și limbile suportate care au traduceri de la furnizor. Link către selecție prin ?lang=de sau ?lang=hr. Fără parametru, Atlas folosește Accept-Language când există conținut potrivit și redirecționează către URL-ul corect de partajare.

Preferă ingredients[] structurate pentru a păstra semnele alergenilor și ecologice. Folosește ingredients_text doar când furnizorul are o declarație completă în proză. Furnizorii pot adăuga valori translations.{language} pentru ingredients_text, designation_of_origin și fiecare instrucțiune packaging[].disposal. Tabloul packaging urmează lungimea și ordinea listei principale; folosește null pentru o instrucțiune care revine la valoarea principală. Traducerile lipsă revin la valoarea principală de nivel superior. REST și MCP returnează această hartă opțională, iar JSON-LD folosește valorile etichetate cu limba. Această hartă furnizată de furnizor este singurul mod în care textul furnizorului se schimbă între limbi.

Corpul solicitării furnizorului urmează E-Label Standard Format.

Pe paginile publice, Atlas redă propriile coduri Standard (productType, color, sweetness, packagingGas, packagingType, materialType și collection) în limba paginii din vocabularul publicat al Standardului. Orice altă valoare a furnizorului rămâne exact cum a fost furnizată.

MCP

Model Context Protocol, sau MCP, este modul standard prin care un client AI apelează instrumente externe. e-label Atlas oferă un server Streamable HTTP anonim la https://www.elabel-atlas.eu/mcp.

Serverul expune search_elabels, lookup_elabel_by_gtin, get_elabel și list_elabels_updated_since.

Instalează Atlas într-un agent

Alege clientul. Pluginul Claude Code și configurarea Codex includ atât ghidul skill Atlas, cât și instrumente MCP live. Alți clienți se conectează la același server MCP doar pentru citire.

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