Trimiterea știrilor și flota NakBus se află acum în panoul de partener

Folosiți același cont de autentificare (e-mail și parolă) ca pentru contul de dezvoltator pentru a vă conecta la panoul Nakordoni Partners și pentru a gestiona acolo știrile și flota de autobuze (NakDriver / NakManager), cu roluri de echipă. Cheile API, endpoint-urile și aplicațiile dvs. rămân neschimbate, iar paginile de aici continuă să funcționeze. Deschide Nakordoni Partners

Recunoașterea numerelor de înmatriculare API (ALPR / ANPR) Online

Citește plăcuțele de înmatriculare dintr-o fotografie a unui vehicul. Trimiteți prin POST o imagine (JPEG, PNG, WebP, BMP sau TIFF, max. 8 MB) ca corp JSON cu image_url sau image_base64, ca încărcare multipart/form-data în câmpul "image" sau ca octeți bruți cu un Content-Type image/*. Fiecare plăcuță găsită este returnată cu textul, un scor 0-1, citiri alternative, chenarul plăcuței în pixeli și scorul de detecție. Motorul este propriul nostru detector și cititor de plăcuțe, optimizat pentru camioane și autobuze europene. Imaginile sunt procesate în memorie și nu sunt niciodată stocate. image_url trebuie să fie o adresă http(s) publică; adresele private și interne, precum și redirecționările către acestea, sunt refuzate, iar descărcarea este oprită după 10 secunde.

POST https://nakordoni.eu/api/v2/data/plate-recognition — clasă de cotă: heavy

Parametru	Descriere
`image_url`	(corp JSON) URL http(s) public al imaginii. Max. 8 MB, max. 3 redirecționări, limită de descărcare 10 s.
`image_base64`	(corp JSON) Imaginea în base64 (un prefix data:image/...;base64, este permis). Trimiteți image_url sau image_base64, nu ambele.

Câmpurile răspunsului — în interiorul obiectului data din plicul răspunsului. [] marchează o listă, deci data.items[].name este câmpul name al fiecărui element. Un câmp este null, lipsește sau este o listă goală atunci când nu avem o valoare — niciodată un substitut.

Câmp	Descriere
`data.success`	true când cel puțin o plăcuță a fost citită; data.message indică câte.
`data.processing_time`	Timpul consumat pentru cerere, în milisecunde (descărcare și recunoaștere).
`data.results[]`	O intrare pentru fiecare plăcuță, începând cu cel mai mare scor de detecție.
`data.results[].plate`	Textul plăcuței, majuscule, doar litere A-Z și cifre (fără spații sau cratime).
`data.results[].score`	Încrederea citirii 0-1 (media încrederilor pe caracter).
`data.results[].candidates[]`	Până la 5 citiri {plate, score}, cea mai bună prima; prima este plăcuța.
`data.results[].region`	{code, score} cu țara plăcuței când motorul o poate stabili; altfel null (motorul actual nu deduce țara).
`data.results[].box`	Poziția plăcuței în pixeli: xmin, ymin, xmax, ymax.
`data.results[].dscore`	Încrederea detecției plăcuței 0-1.
`data.results[].vehicle`	Detalii despre vehicul, când sunt disponibile; null cu motorul actual.
`error.code`	400: image_required, bad_json, bad_base64, one_image_only, bad_image_url, image_url_not_allowed, image_url_fetch_failed, image_url_timeout, invalid_image, unsupported_image_type, unsupported_content_type, upload_failed. 404: no_plate_detected. 413: payload_too_large. 500: engine_error.

curl -X POST "https://nakordoni.eu/api/v2/data/plate-recognition" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://nakordoni.eu/img/developers/plate-recognition-example-bus.jpg"
}'

Față de V1: parametri noi regions, camera_id, timestamp, config, threshold, mode

Ce s-a schimbat în această versiune: v4 completează două câmpuri pe care v2 le returnează mereu ca null. results[].region indică țara plăcuței ca {code, score}, citită din formatul plăcuței: tiparul de litere și cifre al fiecărei țări și, dacă formatul are unul, prefixul regiunii sau al județului (de exemplu CE de pe o plăcuță ucraineană). results[].vehicle indică vehiculul care poartă plăcuța ca {type, score, box}, din detectorul nostru de vehicule: type este car, bus, truck sau motorcycle. v4 acceptă și opțiuni de cerere facultative: regions, camera_id, timestamp, config.threshold și config.mode. Fără ele, rezultatul v4 nu se schimbă. Celelalte câmpuri de răspuns și codurile de eroare din v2 sunt aceleași. v2 returnează în continuare null pentru ambele câmpuri și ignoră opțiunile.

POST https://nakordoni.eu/api/v4/data/plate-recognition — clasă de cotă: heavy

Parametru	Descriere
`image_url`	(corp JSON) URL http(s) public al imaginii. Max. 8 MB, max. 3 redirecționări, limită de descărcare 10 s.
`image_base64`	(corp JSON) Imaginea în base64 (un prefix data:image/...;base64, este permis). Trimiteți image_url sau image_base64, nu ambele.
`regions`	Opțional. Țările pe care le așteptați, ca coduri ISO 3166-1 alpha-2: o matrice JSON ["PL","DE"] sau un șir separat prin virgule "PL,DE" (câmp multipart sau parametru de interogare). Maximum 10. Estimarea regiunii și ordinea citirilor favorizează aceste țări: când cea mai bună citire nu se potrivește cu formatul niciunei țări din listă, dar un alt candidat cu un scor mai mic cu cel mult 0.15 se potrivește, acel candidat devine plăcuța. O plăcuță care nu se potrivește cu nicio țară din listă își păstrează răspunsul normal.
`camera_id`	Opțional. ID-ul camerei sau al porții dvs., maximum 128 de caractere. Returnat neschimbat în data.camera_id. Nu este stocat dincolo de jurnalul normal al cererilor.
`timestamp`	Opțional. Ora capturii în formatul dvs. (de exemplu 2026-10-27T14:05:00Z), maximum 64 de caractere. Returnat neschimbat în data.timestamp. Nu este stocat dincolo de jurnalul normal al cererilor.
`config`	Opțional. Obiect JSON {"threshold": 0-1, "mode": "fast"\|"full"}. Într-un formular multipart sau într-un șir de interogare, trimiteți-l ca șir JSON sau folosiți câmpurile threshold și mode.
`threshold`	Opțional, la fel ca config.threshold. Rezultatele cu un scor sub această valoare (0-1) sunt omise. Când nu rămâne niciunul, răspunsul este 404 no_plate_detected.
`mode`	Opțional, la fel ca config.mode. full (implicit) rulează recunoașterea plăcuței și detectarea vehiculului. fast omite detectarea vehiculului pentru o viteză apropiată de v2: region este completat în continuare, vehicle este null.

Câmp	Descriere
`data.success`	true când cel puțin o plăcuță a fost citită; data.message indică câte.
`data.processing_time`	Timpul petrecut pe cerere, în milisecunde (descărcare, recunoașterea plăcuței și detectarea vehiculului). v4 durează mai mult decât v2 din cauza detectării vehiculului, de obicei 0.5-1.5 s per imagine. Cu config.mode=fast nu există detectarea vehiculului, iar timpul este apropiat de v2.
`data.camera_id`	camera_id pe care l-ați trimis, neschimbat. Prezent doar dacă ați trimis unul.
`data.timestamp`	timestamp-ul pe care l-ați trimis, neschimbat (un șir rămâne șir, un număr rămâne număr). Prezent doar dacă ați trimis unul.
`data.results[]`	O intrare pentru fiecare plăcuță, începând cu cel mai mare scor de detecție.
`data.results[].plate`	Textul plăcuței, majuscule, doar litere A-Z și cifre (fără spații sau cratime).
`data.results[].score`	Încrederea citirii 0-1 (media încrederilor pe caracter).
`data.results[].candidates[]`	Până la 5 citiri {plate, score}, cea mai bună prima; prima este plăcuța.
`data.results[].region`	{code, score}: code este țara plăcuței conform ISO 3166-1 alpha-2 (de exemplu UA, PL, RO), determinată din formatul plăcuței. score 0-1 este încrederea citirii înmulțită cu cât de specific este formatul; când același format este folosit în mai multe țări (de exemplu LT, MD și HU au în comun ABC123), scorul este împărțit între ele și este scăzut. null când textul nu corespunde niciunui format cunoscut. Acoperite: UA, BG, BY, RO, ES, CZ, BE, EE, HU, TR, PL, SK, LV, LT, MD, IT, FR, RS, DE.
`data.results[].box`	Poziția plăcuței în pixeli: xmin, ymin, xmax, ymax.
`data.results[].dscore`	Încrederea detecției plăcuței 0-1.
`data.results[].vehicle`	{type, score, box}: vehiculul care poartă plăcuța. type este car, bus, truck sau motorcycle; score este încrederea detecției 0-1; box este poziția vehiculului în pixeli (xmin, ymin, xmax, ymax). Autocarele văzute din față și microbuzele sau furgonetele pot fi tipizate ca truck (detectorul nu are clasa furgonetă). null când niciun vehicul detectat nu conține plăcuța și mereu null cu config.mode=fast.
`error.code`	400: image_required, bad_json, bad_base64, one_image_only, bad_image_url, image_url_not_allowed, image_url_fetch_failed, image_url_timeout, invalid_image, unsupported_image_type, unsupported_content_type, upload_failed, bad_regions, bad_camera_id, bad_timestamp, bad_config, bad_threshold, bad_mode. 404: no_plate_detected (și când config.threshold nu lasă niciun rezultat). 413: payload_too_large. 500: engine_error.

curl -X POST "https://nakordoni.eu/api/v4/data/plate-recognition" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://nakordoni.eu/img/developers/plate-recognition-example-bus.jpg",
    "regions": [
        "UA"
    ],
    "camera_id": "depot-gate-1",
    "timestamp": "2026-10-27T14:05:00Z",
    "config": {
        "threshold": 0.8
    }
}'

Recunoașterea numerelor de înmatriculare (ANPR / ALPR) pentru vehicule europene

Plate Image Recognition API este un serviciu de recunoaștere a numerelor de înmatriculare (LPR): trimiteți o fotografie și primiți textul plăcuței ca JSON. Este propriul nostru motor ANPR / ALPR, optimizat pe camioane și autobuze din UE la punctele de frontieră și în depourile de autobuze, și citește și plăcuțele de autoturisme și motociclete.

Versiunea v4 adaugă țara plăcuței și tipul vehiculului (car, bus, truck sau motorcycle). Acceptă și opțiuni de cerere facultative: regions, pentru a favoriza rezultatul către țările pe care le așteptați; camera_id și timestamp, care revin în răspuns; un prag de scor; și un mod fast.

RGPD prin design: API-ul este găzduit în UE, iar fiecare imagine este procesată doar în memorie și nu este stocată niciodată. Niciun serviciu de viziune terț nu vă vede imaginile.

Integrări: Home Assistant

Integrarea noastră open source pentru Home Assistant (licență MIT, instalabilă cu HACS) citește numerele de înmatriculare de la camerele dvs. Home Assistant. Vă oferă un senzor și un eveniment pentru fiecare plăcuță, cu țara plăcuței și tipul vehiculului. Suportă Frigate: la un eveniment de vehicul citește instantaneul și scrie plăcuța înapoi în Frigate ca sub-etichetă. Autentificarea folosește OAuth, deci fiecare utilizator primește propria cheie gratuită.

Integrarea Home Assistant pe GitHub ↗ Integrări

🔑 Autentifică-te ca dezvoltator pentru a încerca acest endpoint live în sandbox — 10 apeluri de test gratuite pe produs pe zi. Autentificare

Actualizat 28.10.2026 04:09