Χρησιμοποιήστε τα δεδομένα του Atlas.

Γρήγορη εκκίνηση

Ορίστε το βασικό URL μία φορά και μετά εκτελέστε οποιοδήποτε από τα παρακάτω παραδείγματα.

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

Πιστοποίηση

Ανώνυμα αιτήματα μπορούν να χρησιμοποιήσουν κάθε δημόσιο endpoint ανάγνωσης. Ένα κλειδί αυξάνει το όριο αιτημάτων και είναι απαραίτητο για λειτουργίες εγγραφής παρόχων. Ιδιοκτήτες και διαχειριστές χώρων εργασίας παρόχων μπορούν να δημιουργήσουν κλειδί στον συνδεδεμένο χώρο εργασίας στην ενότητα Κλειδιά API. Αν χρειάζεστε κλειδί ανάγνωσης χωρίς χώρο εργασίας παρόχου ή μαζική πρόσβαση, γράψτε στο david@essentialcode.eu.

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

Όρια αιτημάτων

Κάθε δημόσια λειτουργία επιτρέπει 60 ανώνυμα αιτήματα ανά λεπτό ανά διεύθυνση ή 600 ανά λεπτό ανά κλειδί ανάγνωσης. Οι απαντήσεις περιλαμβάνουν κεφαλίδες limit, remaining και reset. Ένα αίτημα πάνω από το όριο επιστρέφει 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 ανάγνωσης

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

Σελιδοποίηση

Η δημόσια λίστα εγγραφών επιστρέφει next_cursor όταν υπάρχει άλλη σελίδα. Στείλτε αυτή την ακριβή αδιαφανή τιμή με τα ίδια φίλτρα. Μην την αποκωδικοποιείτε ή επεξεργάζεστε.

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"

Γλώσσες δημόσιων εγγραφών

Οι σελίδες δημόσιων εγγραφών τοπικοποιούν μόνο τις δικές τους ετικέτες Atlas και τους κωδικούς που ορίζονται στο E-Label Standard Format, συμπεριλαμβανομένων του τύπου κρασιού, των ιδιοτήτων κρασιού, των κωδικών χωρών, των κλειδιών διατροφικών στοιχείων και των μονάδων. Κάθε κείμενο που έγραψε ο πάροχος παραμένει ακριβώς όπως υποβλήθηκε, συμπεριλαμβανομένων των ονομάτων και κατηγοριών συστατικών και οποιουδήποτε κειμένου συσκευασίας ή απόρριψης που έγραψε ο πάροχος.

Ο πρώτος κωδικός στο languages είναι πάντα η κύρια γλώσσα της εγγραφής, ακόμα και όταν το Atlas δεν μπορεί να αποδώσει τη διεπαφή του σε αυτή τη γλώσσα. Η σελίδα προσφέρει το κύριο περιεχόμενο και τις υποστηριζόμενες γλώσσες που έχουν μεταφράσεις του παρόχου. Σύνδεσμος στην επιλογή μέσω ?lang=de ή ?lang=hr. Χωρίς την παράμετρο, το Atlas χρησιμοποιεί Accept-Language όταν υπάρχει αντίστοιχο περιεχόμενο και ανακατευθύνει στο σωστό κοινοποιήσιμο URL.

Προτιμήστε δομημένα ingredients[] ώστε να διατηρηθούν οι σημαίες αλλεργιογόνων και βιολογικά. Χρησιμοποιήστε ingredients_text μόνο όταν ο πάροχος έχει πλήρη δήλωση σε πρόζα. Οι πάροχοι μπορούν να προσθέσουν τιμές translations.{language} για ingredients_text, designation_of_origin και κάθε οδηγία packaging[].disposal. Ο πίνακας packaging ακολουθεί το μήκος και τη σειρά της κύριας λίστας· χρησιμοποιήστε null για οδηγία που πρέπει να επιστρέψει στην κύρια τιμή. Οι ελλιπείς μεταφράσεις επιστρέφουν στην κύρια τιμή ανώτατου επιπέδου. Τα REST και MCP επιστρέφουν αυτόν τον προαιρετικό χάρτη, και το JSON-LD χρησιμοποιεί τις τιμές με ετικέτα γλώσσας. Αυτός ο χάρτης που παρέχει ο πάροχος είναι ο μοναδικός τρόπος με τον οποίο το κείμενο του παρόχου αλλάζει μεταξύ γλωσσών.

Το σώμα αιτήματος του παρόχου ακολουθεί το E-Label Standard Format.

Στις δημόσιες σελίδες, το Atlas αποδίδει τους δικούς του κωδικούς Standard (productType, color, sweetness, packagingGas, packagingType, materialType και collection) στη γλώσσα της σελίδας από το δημοσιευμένο λεξιλόγιο του Standard. Κάθε άλλη τιμή του παρόχου παραμένει ακριβώς όπως υποβλήθηκε.

MCP

Το Model Context Protocol, ή MCP, είναι ο τυπικός τρόπος με τον οποίο ένας πελάτης AI καλεί εξωτερικά εργαλεία. Το e-label Atlas προσφέρει έναν ανώνυμο Streamable HTTP server στο https://www.elabel-atlas.eu/mcp.

Ο server εκθέτει τα search_elabels, lookup_elabel_by_gtin, get_elabel και list_elabels_updated_since.

Εγκαταστήστε το Atlas σε πράκτορα

Επιλέξτε τον πελάτη σας. Το plugin Claude Code και η ρύθμιση Codex περιλαμβάνουν τόσο τον οδηγό skill Atlas όσο και ζωντανά εργαλεία MCP. Άλλοι πελάτες συνδέονται στον ίδιο 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"
    }
  }
}