Uża d-data ta' Atlas.

Bidu mgħaġġel

Issettja l-URL bażi darba u mbagħad eżegwixxi kwalunkwe eżempju hawn taħt.

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

Awtentikazzjoni

Talb anonimu jista' juża kull endpoint pubbliku tal-qari. Ċavetta tgħolli l-limitu tat-talb u hija meħtieġa għall-operazzjonijiet tal-kitba tal-fornituri. Sidien u amministraturi ta' spazji tax-xogħol tal-fornituri jistgħu joħolqu ċavetta fl-ispazju tax-xogħol illoggjat taħt Ċwievet API. Jekk għandek bżonn ċavetta tal-qari mingħajr spazju tax-xogħol ta' fornitur jew aċċess massiv, ikteb lil david@essentialcode.eu.

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

Limiti tat-talb

Kull operazzjoni pubblika tippermetti 60 talba anonima fil-minuta għal kull indirizz jew 600 fil-minuta għal kull ċavetta tal-qari. It-tweġibiet jinkludu headers limit, remaining u reset. Talba 'l fuq mil-limitu tirritorna 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."}}

Endpoints pubbliċi tal-qari

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

Paġnazzjoni

Il-lista pubblika tar-rekords tirritorna next_cursor meta teżisti paġna oħra. Ibgħat dak il-valur opaku eżatt bl-istess filtri. Tiddikodifikahx u teditjahx.

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"

Lingwi tar-rekords pubbliċi

Il-paġni tar-rekords pubbliċi jillokalizzaw biss it-tikketti ta' Atlas innifsu u l-kodiċijiet definiti fl-E-Label Standard Format, inkluż it-tip tal-inbid, il-proprjetajiet tal-inbid, il-kodiċijiet tal-pajjiżi, iċ-ċwievet tan-nutrizzjoni u l-unitajiet. Kull test miktub mill-fornitur jibqa' eżattament kif intbagħat, inkluż l-ismijiet u l-kategoriji tal-ingredjenti u kull test tal-ippakkjar jew tar-rimi miktub mill-fornitur.

L-ewwel kodiċi f'languages huwa dejjem il-lingwa primarja tar-rekord, anke meta Atlas ma jistax juri l-interface tiegħu f'dik il-lingwa. Il-paġna toffri l-kontenut primarju u l-lingwi appoġġjati li għandhom traduzzjonijiet tal-fornitur. Oħloq link għal għażla b'?lang=de jew ?lang=hr. Mingħajr il-parametru, Atlas juża Accept-Language meta jeżisti kontenut li jaqbel u jirrindirizza lejn l-URL korrispondenti li jista' jinqasam.

Ippreferi ingredients[] strutturati biex l-immarki tal-allerġeni u tal-organiku jinżammu. Uża ingredients_text biss meta l-fornitur ikollu dikjarazzjoni sħiħa f'proża. Il-fornituri jistgħu iżidu valuri translations.{language} għal ingredients_text, designation_of_origin u kull struzzjoni packaging[].disposal. L-array packaging isegwi t-tul u l-ordni tal-lista primarja; uża null għal struzzjoni li għandha taqa' lura fuq il-valur primarju. Traduzzjonijiet nieqsa jaqgħu lura fuq il-valur primarju tal-ogħla livell. REST u MCP jirritornaw din il-mappa mhux obbligatorja, u JSON-LD juża l-valuri ttikkettjati bil-lingwa. Din il-mappa fornuta mill-fornitur hija l-uniku mod kif it-test tal-fornitur jinbidel bejn il-lingwi.

Il-ġisem tat-talba tal-fornitur isegwi l-E-Label Standard Format.

Fuq paġni pubbliċi Atlas jirrendi l-kodiċijiet Standard tiegħu (productType, color, sweetness, packagingGas, packagingType, materialType u collection) fil-lingwa tal-paġna mill-vokabolarju ppubblikat tal-Standard. Kull valur ieħor tal-fornitur jibqa' eżattament kif intbagħat.

MCP

Il-Model Context Protocol, jew MCP, huwa l-mod standard kif klijent AI jsejjaħ għodod esterni. e-label Atlas joffri server Streamable HTTP anonimu fuq https://www.elabel-atlas.eu/mcp.

Is-server jespone search_elabels, lookup_elabel_by_gtin, get_elabel u list_elabels_updated_since.

Installa Atlas f'aġent

Agħżel il-klijent tiegħek. Il-plugin Claude Code u s-setup Codex jinkludu kemm il-gwida tas-skill Atlas kif ukoll għodod MCP ħajjin. Klijenti oħra jgħaqqdu mal-istess server MCP tal-qari biss.

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