Úsáid sonraí Atlas.

Tús tapa

Socraigh an bun-URL uair amháin agus ansin rith aon sampla thíos.

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

Fíordheimhniú

Is féidir le hiarratais gan ainm gach endpoint léitheoireachta poiblí a úsáid. Ardaíonn eochair an teorainn iarratas agus tá sí riachtanach d'oibríochtaí scríofa soláthraithe. Is féidir le húinéirí agus riarthóirí spásanna oibre soláthraithe eochair a chruthú sa spás oibre logáilte isteach faoi Eochracha API. Má theastaíonn eochair léitheoireachta uait gan spás oibre soláthraí nó rochtain mhórcháilte, scríobh chuig david@essentialcode.eu.

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

Teorainneacha iarratais

Ceadaíonn gach oibríocht phoiblí 60 iarratas gan ainm sa nóiméad in aghaidh an tseoltais nó 600 sa nóiméad in aghaidh na heochrach léitheoireachta. Cuimsíonn freagraí ceanntásca limit, remaining agus reset. Filleann iarratas thar an teorainn 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 léitheoireachta poiblí

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

Leathanachú

Filleann liosta poiblí na dtaifead next_cursor nuair a bhíonn leathanach eile ann. Seol an luach doiléir cruinn seo leis na scagairí céanna. Ná déan é a dhíchódú ná a eagrú.

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"

Teangacha taifead poiblí

Ní dhéanann leathanaigh taifead phoiblí ach lipéid Atlas féin agus na cóid a shainmhíonn E-Label Standard Format a áitiúlú, lena n-áirítear cineál fíona, airíonna fíona, cóid tíre, eochracha cothaithe agus aonaid. Fanann gach téacs a scríobh an soláthraí díreach mar a soláthraíodh é, lena n-áirítear ainmneacha agus catagóirí comhábhar agus aon téacs pacáistithe nó diúscartha a scríobh an soláthraí.

Is é an chéad chód i languages i gcónaí príomhtheanga an taifid, fiú nuair nach féidir le Atlas a chomhéadan a rindreáil sa teanga sin. Tugann an leathanach an príomhábhar agus na teangacha tacaithe a bhfuil aistriúcháin ón soláthraí acu. Déan nasc chuig rogha trí ?lang=de nó ?lang=hr. Gan an paraiméadar, úsáideann Atlas Accept-Language nuair a bhíonn ábhar meaitseála ann agus athsheolann sé chuig an URL inroinnte ceart.

Is fearr ingredients[] struchtúrtha chun na bratacha ailléirgin agus orgánacha a chaomhnú. Ná húsáid ingredients_text ach nuair a bhíonn dearbhú próis iomlán ag an soláthraí. Is féidir le soláthraithe luachanna translations.{language} a chur le ingredients_text, designation_of_origin agus gach treoir packaging[].disposal. Leanann an t-eagar packaging fad agus ord an phríomhliosta; bain úsáid as null le haghaidh treoir ar chóir di filleadh siar ar an bpríomhluach. Titeann aistriúcháin in easnamh siar ar an bpríomhluach ardléibheil. Filleann REST agus MCP an léarscáil roghnach seo, agus úsáideann JSON-LD na luachanna atá marcáilte leis an teanga. Is é an léarscáil a sholáthraíonn an soláthraí an t-aon bhealach a n-athraíonn téacs an tsoláthraí idir teangacha.

Leanann corp iarratais an tsoláthraí E-Label Standard Format.

Ar leathanaigh phoiblí, déanann Atlas a chód Standard féin (productType, color, sweetness, packagingGas, packagingType, materialType agus collection) a rindreáil i dteanga an leathanaigh ó fhoclóir foilsithe an Standard. Fanann gach luach eile den soláthraí díreach mar a soláthraíodh é.

MCP

Is é Model Context Protocol, nó MCP, an bealach caighdeánach a nglaoíonn cliant AI ar uirlisí seachtracha. Cuireann e-label Atlas freastalaí Streamable HTTP gan ainm ar fáil ag https://www.elabel-atlas.eu/mcp.

Nochtann an freastalaí search_elabels, lookup_elabel_by_gtin, get_elabel agus list_elabels_updated_since.

Suiteáil Atlas i ngníomhaire

Roghnaigh do chliant. Tá an treoir scile Atlas agus uirlisí beo MCP araon sa bhreiseán Claude Code agus sa socrú Codex. Nascann cliant eile leis an bhfreastalaí céanna MCP léitheoireachta amháin.

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