Τεκμηρίωση του API

Έλεγχος ταυτότητας

Κάθε αίτημα χρειάζεται το κλειδί API σας στην κεφαλίδα Authorization (συνιστάται) ή ως παράμετρο ?key=.

curl "https://nakordoni.eu/api/v1/data/queue?ppid=id_13" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"

Envelope απόκρισης

{
  "ok": true,
  "api_version": "v1",
  "product": "queue",
  "attribution": "Data by nakordoni.eu",
  "terms": "https://nakordoni.eu/en/p/developer_api_terms",
  "data": { ... },
  "usage": { "limit": 1000, "used": 42, "reset": "2026-06-06T00:00:00Z" }
}

Τα σφάλματα επιστρέφουν ok:false με error.code (missing_api_key, invalid_api_key, qps_exceeded, quota_exceeded, unknown_product, product_unavailable, not_approved, bad_request, duplicate_request, market_not_allowed, internal_error, status_unavailable, timeout) και κατάσταση HTTP 400/401/403/404/429/500/503/504. Οι κεφαλίδες ορίου ρυθμού X-Devapi-Limit και X-Devapi-Remaining αποστέλλονται σε κάθε μετρούμενη απόκριση. Το ok:false είναι καθοριστικό — μην διαβάζετε ποτέ το data σε αποτυχημένη κλήση. Το αντικείμενο usage υπάρχει σε κάθε χρεούμενο προϊόν· το /status είναι δημόσιο και μη χρεούμενο, οπότε δεν επιστρέφει usage.

Ποσοστώσεις

Οι ημερήσιοι μετρητές μηδενίζονται τα μεσάνυχτα UTC. Λαμβάνετε ένα email στο 80% και στο 100% της ποσόστωσης.

Τα συνδρομητικά προγράμματα ανεβάζουν κάθε ένα από αυτά τα όρια. Τρέχοντα προγράμματα και τα όριά τους: Προγράμματα

Δείγματα κώδικα

curl

curl "https://nakordoni.eu/api/v1/data/queue?ppid=id_13" \
  -H "Authorization: Bearer $NKD_API_KEY"

JavaScript (fetch)

const res = await fetch('https://nakordoni.eu/api/v1/data/forecast?ppid=id_13&prediction_steps=24', {
  headers: { Authorization: `Bearer ${process.env.NKD_API_KEY}` }
});
const { ok, data, error, usage } = await res.json();
if (!ok) throw new Error(error?.code ?? res.status);
console.log(`forecast points: ${data.length}, calls left today: ${usage.limit - usage.used}`);

Python (requests)

import os, requests

r = requests.get(
    "https://nakordoni.eu/api/v1/data/stats",
    params={"ppid": "id_15", "compare": 1},
    headers={"Authorization": f"Bearer {os.environ['NKD_API_KEY']}"},
    timeout=15,
)
payload = r.json()
print(payload["data"]["daily"], payload["usage"])

Excel (Power Query)

Αντλήστε δεδομένα ουρών, προβλέψεων ή απαγορεύσεων φορτηγών ζωντανά σε ένα βιβλίο εργασίας με τον ενσωματωμένο σύνδεσμο JSON του Power Query — χωρίς κώδικα, με προγραμματισμένη ανανέωση. Το ίδιο μοτίβο Headers λειτουργεί για κάθε προϊόν αυτού του API — αρκεί να αλλάξετε το URL.

Data → Get Data → From Other Sources → Blank Query, then Home → Advanced Editor and paste:

let
    ApiKey = "NKD-DEV-XXXX-XXXX-XXXX",
    Source = Json.Document(Web.Contents("https://nakordoni.eu/api/v1/data/queue",
        [Query = [ppid = "id_13"], Headers = [Authorization = "Bearer " & ApiKey]])),
    data = Source[data],
    AsTable = Record.ToTable(data)
in
    AsTable

Κρατήστε το κλειδί API μέσα στο ερώτημα M (Home → Advanced Editor), όχι σε ένα κελί φύλλου — το Power Query μπλοκάρει ένα αίτημα ιστού που έχει δημιουργηθεί από άλλο ερώτημα ή κελί ("Formula.Firewall"), εκτός αν το επίπεδο απορρήτου έχει οριστεί σε Organizational.

Πολλά συνοριακά σημεία σε έναν πίνακα (πίνακες ελέγχου στόλου) — e.g. every truck crossing UA→PL (crossing_type=9; in v3 that one code covers both freight lanes):

let
    ApiKey = "NKD-DEV-XXXX-XXXX-XXXX",
    Source = Json.Document(Web.Contents("https://nakordoni.eu/api/v4/data/border/1/2/9",
        [Headers = [Authorization = "Bearer " & ApiKey]])),
    checkpoints = Source[data],
    AsTable = Table.FromRecords(checkpoints)
in
    AsTable

Το Data → Refresh All στο Excel, ή μια προγραμματισμένη ανανέωση στο Power BI / Excel Online, διατηρεί τα δεδομένα ενημερωμένα — χωρίς κώδικα polling.

Ενσωμάτωση ERP (BAS / BAF και πλατφόρμες της οικογένειας 1C)

Το BAS / BAF και οι άλλες πλατφόρμες της οικογένειας 1C μπορούν να καλέσουν αυτό το API απευθείας από μια προγραμματισμένη εργασία — HTTPConnection και ReadJSON, χωρίς ενδιάμεσο λογισμικό ή επιπλέον υπηρεσία. Η πιο συνηθισμένη χρήση κρατά ενημερωμένο ένα μητρώο πληροφοριών με τις τιμές καυσίμων στην ΕΕ.

Ενημέρωση μητρώου πληροφοριών (τιμές καυσίμων, όλες οι χώρες σε μία κλήση)

// Scheduled job — runs once a day
Connection = New HTTPConnection("nakordoni.eu", 443, , , , 30, New OpenSSLSecureConnection);

Headers = New Map;
Headers.Insert("Authorization", "Bearer NKD-DEV-XXXX-XXXX-XXXX");

Request  = New HTTPRequest("/api/v1/data/fuel", Headers);
Response = Connection.Get(Request);

Reader = New JSONReader;
Reader.SetString(Response.GetBodyAsString("UTF-8"));
Answer = ReadJSON(Reader, True);
Reader.Close();

If Answer["ok"] <> True Then
    // Answer["error"]["code"] says why; Answer["usage"] holds your quota state
    Return;
EndIf;

For Each Row In Answer["data"] Do
    Record = InformationRegisters.FuelPrices.CreateRecordManager();
    Record.Period   = CurrentSessionDate();
    Record.Country  = Row["country"];    // "PL", "DE", "SK", "RO", ...
    Record.Diesel   = Row["diesel"];
    Record.Petrol   = Row["petrol"];
    Record.LPG      = Row["lpg"];
    Record.Currency = Row["currency"];
    Record.Write();
EndDo;

Τρία σημεία που πρέπει να πετύχετε: περάστε New OpenSSLSecureConnection στη θύρα 443, αλλιώς το αίτημα σκάει στο TLS· καλέστε το /api/v1/data/fuel χωρίς την παράμετρο country, ώστε ένα αίτημα να επιστρέψει όλες τις χώρες αντί για μία κλήση ανά χώρα· και ελέγξτε το ok πριν αγγίξετε το data — τα σφάλματα επιστρέφουν ως ok:false με error.code, όχι ως εξαίρεση. Το παράδειγμα χρησιμοποιεί το αγγλικό σύνολο λέξεων-κλειδιών της πλατφόρμας· τα τοπικοποιημένα αντίστοιχα (HTTPСоединение, ПрочитатьJSON, РегистрыСведений) συμπεριφέρονται ίδια.

Οι τιμές καυσίμων αλλάζουν στην πηγή μία φορά την ημέρα, οπότε μια προγραμματισμένη εργασία μία ή δύο φορές την ημέρα αρκεί και μένει πολύ μέσα στο δωρεάν όριο Explorer. Τα ζωντανά δεδομένα ουρών (queue, multi, border) αλλάζουν κάθε λίγα λεπτά — ρωτήστε τα με δικό σας ρυθμό και χρησιμοποιήστε το multi για να διαβάσετε έως 5 συνοριακά σημεία σε ένα αίτημα αντί για βρόχο.

Διακομιστής MCP

Προτιμάτε την κλήση εργαλείων αντί για REST; Λειτουργούμε έναν πραγματικό διακομιστή MCP (μεταφορά Streamable HTTP) που εκθέτει ένα ασφαλές, μόνο για ανάγνωση υποσύνολο αυτού του API ως εργαλεία MCP — το ίδιο κλειδί API, η ίδια ποσόστωση, απλώς διαφορετική μεταφορά.

Endpoint: https://nakordoni.eu/mcp · Server card: /.well-known/mcp/server-card.json

get_api_status      — no key required
list_checkpoints     — country, lang
get_border_queue     — origin, destination, crossing_type, lang
get_live_queue       — ppid, lang
get_queue_forecast   — ppid, prediction_steps

Διαμόρφωση πελάτη (Claude Desktop / Claude Code):

{
  "mcpServers": {
    "nakordoni": {
      "url": "https://nakordoni.eu/mcp",
      "headers": { "Authorization": "Bearer NKD-DEV-XXXX-XXXX-XXXX" }
    }
  }
}

OAuth για ολοκληρώσεις (Home Assistant και άλλες)

Οι ολοκληρώσεις των οποίων οι χρήστες χρειάζονται ο καθένας το δικό του κλειδί (προσαρμοσμένες ολοκληρώσεις Home Assistant, εφαρμογές για υπολογιστή και κινητά) μπορούν να αφήσουν τον χρήστη να συνδεθεί αντί να επικολλήσει κλειδί. Η ροή είναι OAuth 2.0 authorization code για δημόσιους πελάτες με PKCE (S256) — δεν υπάρχει client secret. Το διακριτικό πρόσβασης που επιστρέφουμε είναι το ίδιο το κλειδί NKD-DEV του χρήστη, το οποίο στέλνετε στη συνέχεια σε κεφαλίδα Bearer ακριβώς όπως σήμερα.

Οι πελάτες δεν δημιουργούνται αυτόνομα: κάντε αίτηση στη σελίδα Ολοκληρώσεων, εξετάζουμε κάθε ολοκλήρωση χειροκίνητα και εκδίδουμε client ID με τα επιτρεπόμενα URI ανακατεύθυνσης. Τα κλειδιά που εκδίδονται μέσω εγκεκριμένου πελάτη ενεργοποιούνται άμεσα για τις αγορές που έχουν εγκριθεί για αυτή την ολοκλήρωση. Αίτηση για πελάτη ολοκλήρωσης →

• Ο κωδικός εξουσιοδότησης ισχύει για 60 δευτερόλεπτα, είναι μίας χρήσης και συνδέεται με τον πελάτη, τον χρήστη, το URI ανακατεύθυνσης και το PKCE challenge.
• Το κλειδί επιστρέφεται μόνο στο σώμα της απάντησης διακριτικού (access_token) — ποτέ σε URL. Φυλάξτε το όπως έναν κωδικό πρόσβασης.
• Το expires_in είναι 30 ημέρες· μια ανανέωση επιστρέφει το ίδιο κλειδί όσο είναι ενεργό. Αν ο χρήστης ανακαλέσει ή αναδημιουργήσει το κλειδί, η ανανέωση αποτυγχάνει με invalid_grant και οι κλήσεις API επιστρέφουν 401 — ξεκινήστε εκ νέου τον έλεγχο ταυτότητας.
• Τα αιτήματα έχουν περιορισμό ρυθμού ανά IP και ημερήσιο όριο ανά πελάτη· τα σφάλματα ακολουθούν το RFC 6749 (error, error_description).
• Κάθε χρήστης λαμβάνει το πολύ το δικό του όριο χωρών: αν η ενσωμάτωσή σας περιλαμβάνει περισσότερες χώρες από τις ελεύθερες θέσεις του, τις επιλέγει στη σελίδα συναίνεσης (στείλτε markets=DE,AT στο /oauth/authorize για προεπιλογή). Και οι δύο απαντήσεις token επιστρέφουν επίσης markets_approved (εγκεκριμένες χώρες του χρήστη), markets_allowed (το όριό του· null = απεριόριστο), markets_available (οι χώρες σας που δεν έχει ακόμη) και upgrade_url (όπου προσθέτει «Επιπλέον χώρες»).

curl -X POST https://api.nakordoni.dev/oauth/token \
  -d grant_type=authorization_code -d client_id=nkd_xxxxxxxxxxxxxxxxxxxxxxxx \
  -d code=CODE -d code_verifier=VERIFIER \
  -d redirect_uri=https://my.home-assistant.io/redirect/oauth

{"access_token":"NKD-DEV-XXXX-XXXX-XXXX","token_type":"Bearer","expires_in":2592000,
 "refresh_token":"nkdrt_…","scope":"data","markets_approved":["DE"]}

Home Assistant

Χρησιμοποιήστε το config_entry_oauth2_flow με το LocalOAuth2ImplementationWithPkce (client_secret κενό) και το URI ανακατεύθυνσης https://my.home-assistant.io/redirect/oauth, που είναι προεγγεγραμμένο για πελάτες Home Assistant. Διαβάστε το κλειδί από το entry.data["token"]["access_token"] και συνεχίστε να καλείτε το API με Authorization: Bearer. Σε 401 από το API, ενεργοποιήστε το ConfigEntryAuthFailed ώστε το Home Assistant να προσφέρει εκ νέου έλεγχο ταυτότητας.

from homeassistant.helpers import config_entry_oauth2_flow

impl = config_entry_oauth2_flow.LocalOAuth2ImplementationWithPkce(
    hass, DOMAIN, client_id="nkd_xxxxxxxxxxxxxxxxxxxxxxxx",
    authorize_url="https://api.nakordoni.dev/oauth/authorize",
    token_url="https://api.nakordoni.dev/oauth/token",
)
config_entry_oauth2_flow.async_register_implementation(hass, DOMAIN, impl)

Ενσωματώσεις: εμφάνιση των υπόλοιπων ορίων

GET /api/v2/account/usage — Τι απομένει από τα όριά σας αυτή τη στιγμή, για το κλειδί με το οποίο καλείτε: πρόγραμμα, όριο ανά δευτερόλεπτο και για κάθε κλάση ημερήσιου ορίου (cheap, heavy, route) όριο, χρήση, υπόλοιπο και ώρα μηδενισμού (μεσάνυχτα UTC)· επίσης οι χώρες σας όπως τις βλέπει αυτό το κλειδί και πού γίνεται αναβάθμιση. Δεν χρεώνεται, 30 κλήσεις ανά λεπτό ανά κλειδί.

Τα κλειδιά ενσωμάτωσης (OAuth) μπορούν πάντα να καλούν το GET /api/v2/account/usage, ανεξάρτητα από τα προϊόντα που επιτρέπει η ενσωμάτωση. Οι αριθμοί ταυτίζονται με τις κεφαλίδες X-Devapi-Limit και X-Devapi-Remaining· το X-Devapi-Reset δίνει την ώρα μηδενισμού ως Unix timestamp.

{"ok":true,"api_version":"v2","product":"account-usage","data":{
 "plan":{"slug":"explorer","name":"Explorer"},"qps":2,
 "quotas":{"cheap":{"limit":1000,"used":42,"remaining":958,"reset_at":"2026-10-17T00:00:00Z"},"heavy":{…},"route":{…}},
 "markets":{"approved":["DE"],"allowed":1,"available":["AT"],"key_bound":true},
 "pass":{"active":true,"expires_at":"2026-10-19T14:05:00Z","days_left":3},"upgrade_url":"https://nakordoni.eu/en/developers/billing",
 "pass_url":"https://nakordoni.eu/en/developers/billing?section=trip-pass#trip-pass"}}

Όταν εξαντληθεί ένα όριο, το σφάλμα λέει πού να πάτε: το 429 quota_exceeded επιστρέφει επίσης error.reset_at (μεσάνυχτα UTC) και error.upgrade_url· τα 403 market_not_allowed και 403 integration_product_not_allowed επιστρέφουν error.upgrade_url. Τα κλειδιά ενσωμάτωσης παίρνουν επίσης error.pass_url (Trip Pass, παρακάτω).

Home Assistant: ερωτάτε το /account/usage το πολύ κάθε 15 λεπτά και εκθέστε έναν αισθητήρα «υπόλοιπες κλήσεις» από το quotas.cheap.remaining. Ανάμεσα στις ερωτήσεις διαβάζετε το X-Devapi-Remaining από τις κανονικές κλήσεις. Σε 429 quota_exceeded ή 403 market_not_allowed δημιουργήστε ένα repair issue με σύνδεσμο στο error.upgrade_url και σταματήστε τις κλήσεις έως το reset_at.

Trip Pass

Οι χρήστες ενσωματώσεων μπορούν να αγοράσουν Trip Pass (1, 3, 7 ή 14 ημέρες, εφάπαξ πληρωμή) στη σελίδα Χρέωσης. Όσο είναι ενεργό, το κλειδί της ενσωμάτωσης παίρνει όλες τις χώρες της ενσωμάτωσης, περισσότερες κλήσεις διαδρομής φορτηγού και δεδομένων ανά ημέρα και υψηλότερο ρυθμό· τα προϊόντα της ενσωμάτωσης, τα όρια προβλέψεων και η καθυστέρηση των δεδομένων δεν αλλάζουν. Τα κλειδιά προγραμματιστή του ίδιου λογαριασμού δεν αυξάνονται ποτέ.

Για κλειδιά ενσωμάτωσης, το account/usage επιστρέφει pass: {active, expires_at, days_left} και pass_url (ενότητα Trip Pass της σελίδας Χρέωσης)· τα 429 quota_exceeded και 403 market_not_allowed / integration_product_not_allowed φέρουν το ίδιο error.pass_url. Για άλλα κλειδιά και τα δύο είναι null.

Country and vehicle-type codes

Border endpoints address countries and vehicle types by numeric id: /api/v1/data/border/{origin}/{destination}/{crossing_type}. destination also accepts a comma-separated list or the word all. The ids are stable and are the same in every product that takes an origin, a destination or a crossing_type.

Country ids

The border products accept the ids marked as origins below; the neighbours column is what destination=all expands to for that origin. Ids without neighbours are countries we name in responses but hold no crossings for yet. The Checkpoints Directory returns the origin, destination and crossing_type of every crossing we actually serve, so it stays the authoritative list.

Vehicle types (crossing_type)

The label in this table is the crossing_type_label the API returns with every response, in the language you request. Types outside the accepted list belong to crossings the directory carries but the border products do not answer for — ferry (10-13), freight up to 3.5 t (14) and rail (15) — and asking for one returns 400, not an empty result. Read crossing_type from the Checkpoints Directory rather than assuming: a crossing returns data only for the types it actually has.

Προϊόντα

Επιλέξτε ένα endpoint για την πλήρη αναφορά του, τις παραμέτρους, τις εκδόσεις και ένα ζωντανό Sandbox.

Πρότυπος αντλεί από το πρότυπο όριο δεδομένων  ·  Βαρύ αντλεί από το πιστωτικό όριο προβλέψεων και στατιστικών — βλέπε Ποσοστώσεις  ·  Διαδρομή φορτηγού καταναλώνει το δικό του όριο διαδρομών φορτηγών — δείτε Ποσοστώσεις

Ουρές στα σύνορα

Προβλέψεις και Στατιστικές

Καύσιμα και Τοποθεσίες

Ανταλλακτήρια συναλλάγματος

Σχεδιασμός Ταξιδιού

Εφοδιαστική

Οδηγοί και Δρόμοι

Your Fleet (NakBus Live)

Βοηθός ΤΝ

Άλλα

Εξαγωγή ιστορικών δεδομένων

Οι εγκεκριμένοι προγραμματιστές μπορούν να κατεβάσουν το δημοσιευμένο ιστορικό των συνοριακών ουρών, με ωριαίο μέσο όρο, για έως 5 συνοριακά σημεία (κυλιόμενο παράθυρο έως 90 ημερών) ως συμπιεσμένο gzip CSV, NDJSON ή JSON. Πρόκειται για λειτουργία μόνο της πύλης — ΟΧΙ για endpoint του API· τις εξαγωγές τις δημιουργείτε και τις κατεβάζετε από την καρτέλα «Εξαγωγή δεδομένων» στον λογαριασμό σας.

Η πρόσβαση παρέχεται κατόπιν αιτήματος: ανοίξτε ένα αίτημα υποστήριξης τύπου Data λέγοντάς μας ποια συνοριακά σημεία, το χρονικό διάστημα και τη σκοπούμενη χρήση. Μετά την έγκριση, η καρτέλα «Εξαγωγή δεδομένων» εμφανίζεται στον λογαριασμό σας. Προεπιλεγμένο όριο: 1 εξαγωγή/ημέρα, έως 5 σημεία η καθεμία — ζητήστε μας να το αυξήσουμε.

Πεδία — μία γραμμή ανά συνοριακό σημείο ανά ώρα UTC

Εξάγονται μόνο δημοσιευμένα δεδομένα, τα οποία περνούν τους ελέγχους ανωμαλιών και ποιότητας πριν από την εξαγωγή (χωρίς ακατέργαστες μεμονωμένες αναφορές). Όλες οι χρονοσημάνσεις είναι σε UTC. Τα αρχεία διατηρούνται για 10 ημέρες.

Προέλευση: κάθε αρχείο ενσωματώνει στην κεφαλίδα του ένα υπογεγραμμένο αποτύπωμα (sha256 + HMAC), ώστε οποιοδήποτε αντίγραφο να μπορεί αργότερα να επιβεβαιωθεί ως γνήσια δεδομένα του nakordoni.eu και να ελεγχθεί για αλλοιώσεις — ακόμη και μετά τη λήψη.

# sha256: 3f9c…   # signature: e87b…
ppid,checkpoint_name,hour_utc,direction,vehicle_type,avg_queue_length,avg_wait_minutes,sample_count
id_10,Hrushiv,2026-06-12T02:00:00Z,UA->PL,car,11,,4

Τι μπορείτε να δημιουργήσετε

Τα ίδια προϊόντα δεδομένων αποδίδουν τα γραφικά στο nakordoni.eu — εβδομαδιαία γραφήματα πρόβλεψης, ωριαία προφίλ ουρών, κάρτες κατάστασης σε πραγματικό χρόνο. Μια γεύση από το τι περιέχουν τα API προβλέψεων και στατιστικών:

Απόδοση πηγής

Οι ενσωματώσεις του προγράμματος Explorer πρέπει να εμφανίζουν έναν ορατό σύνδεσμο "Data by nakordoni.eu" όπου εμφανίζονται τα δεδομένα. Αυτό κρατά δωρεάν το δωρεάν πρόγραμμα.

Ο ακριβής κώδικας

Αντιγράψτε αυτό το απόσπασμα ως έχει. Ο σύνδεσμος πρέπει να παραμείνει ευρετηριάσιμος: ορατό, απλό HTML <a href> δίπλα στα δεδομένα, που η Google μπορεί να ευρετηριάσει και να ακολουθήσει — ΜΗΝ προσθέσετε rel="nofollow", rel="sponsored" ή rel="ugc" και μην τον κρύβετε με CSS. Σύνδεσμος που προστίθεται με JavaScript είναι αποδεκτός αν εμφανίζεται στη σελίδα που αποδίδει η Google (Όροι Developer API v1.0, ενότητα 8.1).

<a href="https://nakordoni.eu/" title="Border queues, forecasts &amp; statistics">Data by nakordoni.eu</a>

Συμπαγής παραλλαγή με μικρά γράμματα (π.χ. κάτω από γράφημα ή widget):

<p style="font-size:12px;margin:4px 0">
  Data by <a href="https://nakordoni.eu/">nakordoni.eu</a>
</p>

Μπορείτε να συνδέσετε τη δική σας γλωσσική έκδοση, π.χ. https://nakordoni.eu/el/ — μετράει οποιοσδήποτε ορατός απλός σύνδεσμος HTML προς το nakordoni.eu. Το κείμενο αγκύρωσης "Data by nakordoni.eu" πρέπει να παραμείνει στα αγγλικά.

Πού να τοποθετηθεί

• Ακριβώς δίπλα ή κάτω από το μπλοκ δεδομένων (πίνακας, γράφημα, widget, απάντηση) — στην ίδια οθόνη, ορατό χωρίς επιπλέον κλικ.
• Σε κάθε σελίδα ή οθόνη εφαρμογής όπου εμφανίζονται τα δεδομένα μας — όχι μόνο σε μια σελίδα "σχετικά".
• Ευανάγνωστο μέγεθος και αντίθεση: τουλάχιστον ~11px, όχι κρυμμένο, όχι συμπτυγμένο, όχι στο χρώμα του φόντου.
• Εγγενείς εφαρμογές κινητών χωρίς HTML συνδέσμους: εμφανίστε το κείμενο "Data by nakordoni.eu" στην οθόνη δεδομένων και βάλτε τον σύνδεσμο στην οθόνη πληροφοριών.

Ελέγχουμε περιοδικά την αναφορά πηγής στη "σελίδα όπου χρησιμοποιούνται τα δεδομένα" που δηλώσατε κατά την εγγραφή. Η απούσα ή κρυμμένη αναφορά στο δωρεάν πρόγραμμα Explorer οδηγεί πρώτα σε υπενθύμιση και στη συνέχεια σε αναστολή του κλειδιού. Οι πελάτες με επί πληρωμή πρόγραμμα μπορούν να την παραλείψουν.

Οι έλεγχοι γίνονται περίπου μία φορά την εβδομάδα από τον ελεγκτή μας, του οποίου το user agent περιέχει NakordoniComplianceBot/1.0. Ανοίγει μόνο τις σελίδες που έχετε δηλώσει στον πίνακα προγραμματιστή, δεν ακολουθεί άλλους συνδέσμους και αγνοεί το robots.txt για αυτές τις σελίδες, επειδή αυτές ακριβώς μας ζητήσατε να ελέγχουμε. Αν κάποια προστασία από bots ή τείχος προστασίας μπλοκάρει άγνωστους crawlers, επιτρέψτε αυτό το user agent — αν δεν μπορούμε να ανοίξουμε μια σελίδα, θα σας γράψουμε με αίτημα υποστήριξης.

Άδεια δεδομένων και αγορές

Το κλειδί API σας παρέχει άδεια χρήσης των δεδομένων μας μόνο στις χώρες που δηλώσατε κατά την εγγραφή σας. Εξετάζουμε κάθε δήλωση πριν χορηγήσουμε πλήρη πρόσβαση, διότι τα δεδομένα μας είναι δικό μας προϊόν και δεν τα αδειοδοτούμε σε αγορές χωρίς να γνωρίζουμε πού θα δημοσιευτούν.

• Δηλώστε κάθε χώρα που εξυπηρετεί ο ιστότοπος, η εφαρμογή ή το προϊόν σας. Μπορείτε να αλλάξετε τη λίστα ανά πάσα στιγμή από τον πίνακα ελέγχου σας· μια αλλαγή επαναφέρει τον λογαριασμό σας σε εξέταση.
• Μέχρι να εγκριθούν οι αγορές σας, το κλειδί σας λειτουργεί με μειωμένα όρια — το μισό της χορήγησης του πλάνου Starter. Αυτό ισχύει ανεξάρτητα από το πλάνο σας.
• Ενδέχεται να εγκρίνουμε μόνο ορισμένες από τις χώρες που ζητήσατε. Η εγκεκριμένη λίστα, όχι αυτή που ζητήσατε, καθορίζει τις χώρες που καλύπτει η άδεια σας.
• Η δημοσίευση ή αναδιανομή των δεδομένων μας σε αγορά που δεν δηλώσατε, ή η μεταπώλησή τους ως ανταγωνιστική ροή δεδομένων, παραβιάζει αυτούς τους όρους και μπορεί να αναστείλει το κλειδί σας χωρίς προειδοποίηση.
• Ορισμένα πλάνα προσφέρονται μόνο σε επιλεγμένες περιοχές. Η διαθεσιμότητα εξαρτάται από τις αγορές που δηλώνετε.
• Η πλήρης συμφωνία είναι οι Όροι Developer API. Υπερισχύουν αυτής της περίληψης· δεσμευτική είναι η αγγλική έκδοση.

Ενημερότητα δεδομένων

Το πόσο πρόσφατα είναι τα δεδομένα σας εξαρτάται από το πρόγραμμά σας. Στην ίδια την απόκριση δεν υπάρχει καμία ένδειξη — όλα τα προγράμματα επιστρέφουν τα ίδια πεδία, τους ίδιους τύπους και την ίδια δομή απόκρισης.

• Προγράμματα επί πληρωμή — Student, Starter, Pro και Pro MAX: ζωντανή τηλεμετρία, χωρίς καθυστέρηση.
• Δωρεάν πρόγραμμα Explorer: στιγμιότυπο από τα τελευταία 15 έως 30 λεπτά. Η ακριβής απόκλιση διαφέρει από αίτημα σε αίτημα.

Μια καθυστερημένη απόκριση δεν είναι ποτέ σφάλμα ούτε πρόβλημα ορίου — είναι μια πλήρης, έγκυρη απόκριση με παλαιότερους αριθμούς. Η επανάληψη του αιτήματος δεν επιστρέφει νεότερα δεδομένα.

Αν η εφαρμογή σας χρειάζεται τρέχοντα δεδομένα, οποιοδήποτε πρόγραμμα επί πληρωμή επιστρέφει τηλεμετρία σε πραγματικό χρόνο.

Αποκτήστε το δωρεάν κλειδί API σας