Dërgimi i lajmeve dhe flota NakBus tani janë në panelin e partnerit

Përdorni të njëjtat të dhëna hyrjeje (email-in dhe fjalëkalimin) si për llogarinë tuaj të zhvilluesit për t'u identifikuar në panelin Nakordoni Partners dhe për të menaxhuar aty lajmet dhe flotën tuaj të autobusëve (NakDriver / NakManager), me role ekipi. Çelësat tuaj API, pikat fundore dhe aplikacionet mbeten të pandryshuara, dhe faqet këtu vazhdojnë të funksionojnë. Hap Nakordoni Partners

API për njohjen e targave (ALPR / ANPR) Online

Lexon targat e automjeteve nga një fotografi e një automjeti. Dërgoni me POST një imazh (JPEG, PNG, WebP, BMP ose TIFF, maks. 8 MB) si trup JSON me image_url ose image_base64, si ngarkim multipart/form-data në fushën "image", ose si bajte të papërpunuara me Content-Type image/*. Çdo targë e gjetur kthehet me tekstin, një vlerësim 0-1, leximet alternative, kutinë e targës në piksel dhe vlerësimin e zbulimit. Motori është detektori dhe lexuesi ynë i targave, i përshtatur për kamionë dhe autobusë evropianë. Imazhet përpunohen në memorie dhe nuk ruhen kurrë. image_url duhet të jetë një adresë publike http(s); adresat private dhe të brendshme, si dhe ridrejtimet drejt tyre, refuzohen, dhe shkarkimi ndalet pas 10 sekondash.

POST https://nakordoni.eu/api/v2/data/plate-recognition — klasa e kuotës: heavy

Parametri	Përshkrimi
`image_url`	(Trup JSON) URL publike http(s) e imazhit. Maks. 8 MB, maks. 3 ridrejtime, kufi shkarkimi 10 s.
`image_base64`	(Trup JSON) Imazhi në base64 (lejohet parashtesa data:image/...;base64,). Dërgoni image_url ose image_base64, jo të dyja.

Fushat e përgjigjes — brenda objektit data të zarfit të përgjigjes. [] shënon një listë, pra data.items[].name është fusha name e çdo elementi. Një fushë është null, mungon ose është listë bosh kur nuk kemi vlerë — kurrë një vendmbajtëse.

Fusha	Përshkrimi
`data.success`	true kur është lexuar të paktën një targë; data.message tregon sa.
`data.processing_time`	Koha e shpenzuar për kërkesën në milisekonda (shkarkimi dhe njohja).
`data.results[]`	Një hyrje për çdo targë, me vlerësimin më të lartë të zbulimit së pari.
`data.results[].plate`	Teksti i targës, me shkronja të mëdha, vetëm shkronja A-Z dhe shifra (pa hapësira ose viza).
`data.results[].score`	Besueshmëria e leximit 0-1 (mesatarja e besueshmërive të secilit karakter).
`data.results[].candidates[]`	Deri në 5 lexime {plate, score}, më i miri së pari; i pari është targa.
`data.results[].region`	{code, score} me shtetin e targës kur motori mund ta përcaktojë; null në të kundërt (motori aktual nuk e nxjerr shtetin).
`data.results[].box`	Pozicioni i targës në piksel: xmin, ymin, xmax, ymax.
`data.results[].dscore`	Besueshmëria e zbulimit të targës 0-1.
`data.results[].vehicle`	Detajet e automjetit kur janë të disponueshme; null me motorin aktual.
`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"
}'

Krahasuar me V1: parametra të rinj regions, camera_id, timestamp, config, threshold, mode

Çfarë ka ndryshuar në këtë version: v4 plotëson dy fusha që v2 i kthen gjithmonë si null. results[].region jep shtetin e targës si {code, score}, i lexuar nga formati i targës: modeli i shkronjave dhe shifrave të secilit shtet dhe, kur formati e ka, prefiksi i rajonit ose i qarkut (për shembull CE në një targë ukrainase). results[].vehicle jep mjetin që mban targën si {type, score, box}, nga detektori ynë i mjeteve: type është car, bus, truck ose motorcycle. v4 pranon edhe opsione opsionale të kërkesës: regions, camera_id, timestamp, config.threshold dhe config.mode. Pa to, dalja e v4 nuk ndryshon. Fushat e tjera të përgjigjes dhe kodet e gabimit të v2 janë të njëjta. v2 vazhdon të kthejë null për të dyja fushat dhe i injoron opsionet.

POST https://nakordoni.eu/api/v4/data/plate-recognition — klasa e kuotës: heavy

Parametri	Përshkrimi
`image_url`	(Trup JSON) URL publike http(s) e imazhit. Maks. 8 MB, maks. 3 ridrejtime, kufi shkarkimi 10 s.
`image_base64`	(Trup JSON) Imazhi në base64 (lejohet parashtesa data:image/...;base64,). Dërgoni image_url ose image_base64, jo të dyja.
`regions`	Opsionale. Shtetet që prisni, si kode ISO 3166-1 alpha-2: një varg JSON ["PL","DE"] ose një string i ndarë me presje "PL,DE" (fushë multipart ose parametër query). Deri në 10. Hamendja e rajonit dhe renditja e leximit anojnë drejt këtyre shteteve: kur leximi më i mirë nuk përputhet me formatin e asnjë shteti të listuar, por një kandidat tjetër me rezultat jo më shumë se 0,15 më të ulët përputhet, ai kandidat bëhet targa. Një targë që nuk përputhet me asnjë shtet të listuar mban përgjigjen e saj normale.
`camera_id`	Opsionale. ID e kamerës ose e portës suaj, deri në 128 karaktere. Kthehet pa ndryshim te data.camera_id. Nuk ruhet përtej regjistrit normal të kërkesave.
`timestamp`	Opsionale. Koha e kapjes në formatin tuaj (për shembull 2026-10-27T14:05:00Z), deri në 64 karaktere. Kthehet pa ndryshim te data.timestamp. Nuk ruhet përtej regjistrit normal të kërkesave.
`config`	Opsionale. Objekt JSON {"threshold": 0-1, "mode": "fast"\|"full"}. Në një formular multipart ose në një query string, dërgojeni si string JSON ose përdorni fushat threshold dhe mode.
`threshold`	Opsionale, njësoj si config.threshold. Rezultatet me score nën këtë vlerë (0-1) lihen jashtë. Kur nuk mbetet asnjë, përgjigjja është 404 no_plate_detected.
`mode`	Opsionale, njësoj si config.mode. full (e parazgjedhur) ekzekuton njohjen e targës dhe zbulimin e mjetit. fast e anashkalon zbulimin e mjetit për shpejtësi si v2: region plotësohet prapë, vehicle është null.

Fusha	Përshkrimi
`data.success`	true kur është lexuar të paktën një targë; data.message tregon sa.
`data.processing_time`	Koha e shpenzuar për kërkesën në milisekonda (shkarkim, njohje e targës dhe zbulim i mjetit). v4 zgjat më shumë se v2 për shkak të zbulimit të mjetit, zakonisht 0,5-1,5 s për imazh. Me config.mode=fast nuk ka zbulim mjeti dhe koha është afër v2.
`data.camera_id`	camera_id që dërguat, pa ndryshim. Ekziston vetëm kur e dërguat.
`data.timestamp`	timestamp që dërguat, pa ndryshim (një string mbetet string, një numër mbetet numër). Ekziston vetëm kur e dërguat.
`data.results[]`	Një hyrje për çdo targë, me vlerësimin më të lartë të zbulimit së pari.
`data.results[].plate`	Teksti i targës, me shkronja të mëdha, vetëm shkronja A-Z dhe shifra (pa hapësira ose viza).
`data.results[].score`	Besueshmëria e leximit 0-1 (mesatarja e besueshmërive të secilit karakter).
`data.results[].candidates[]`	Deri në 5 lexime {plate, score}, më i miri së pari; i pari është targa.
`data.results[].region`	{code, score}: code është shteti ISO 3166-1 alpha-2 i targës (për shembull UA, PL, RO), i lexuar nga formati i targës. score 0-1 është besueshmëria e leximit e shumëzuar me specifikën e formatit; kur i njëjti format përdoret në disa shtete (për shembull LT, MD dhe HU ndajnë ABC123) vlerësimi ndahet mes tyre dhe është i ulët. null kur teksti nuk përputhet me asnjë format të njohur. Të mbuluara: UA, BG, BY, RO, ES, CZ, BE, EE, HU, TR, PL, SK, LV, LT, MD, IT, FR, RS, DE.
`data.results[].box`	Pozicioni i targës në piksel: xmin, ymin, xmax, ymax.
`data.results[].dscore`	Besueshmëria e zbulimit të targës 0-1.
`data.results[].vehicle`	{type, score, box}: mjeti që mban targën. type është car, bus, truck ose motorcycle; score është besueshmëria e zbulimit 0-1; box është pozicioni i mjetit në piksele (xmin, ymin, xmax, ymax). Autobusët turistikë të parë nga përpara dhe minibusët ose furgonët mund të klasifikohen si truck (detektori nuk ka klasë van). null kur asnjë mjet i zbuluar nuk e përmban targën, dhe gjithmonë null me 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 (edhe kur config.threshold nuk lë asnjë 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
    }
}'

Njohja e targave (ANPR / ALPR) për mjetet evropiane

Plate Image Recognition API është një shërbim për njohjen e targave (LPR): dërgoni një foto dhe merrni tekstin e targës si JSON. Është motori ynë ANPR / ALPR, i përshtatur në kamionë dhe autobusë të BE-së në pika kufitare dhe depo autobusësh, dhe lexon edhe targa makinash e motoçikletash.

Versioni v4 shton shtetin e targës dhe llojin e mjetit (car, bus, truck ose motorcycle). Pranon edhe opsione opsionale të kërkesës: regions, për ta anuar rezultatin drejt shteteve që prisni; camera_id dhe timestamp, që kthehen në përgjigje; një prag rezultati; dhe një mënyrë fast.

GDPR që nga dizajni: API-ja hostohet në BE dhe çdo imazh përpunohet vetëm në memorie dhe nuk ruhet kurrë. Asnjë shërbim i jashtëm vizioni nuk i sheh imazhet tuaja.

Integrime: Home Assistant

Integrimi ynë open-source për Home Assistant (licencë MIT, instalohet me HACS) lexon targat nga kamerat tuaja të Home Assistant. Ju jep një sensor dhe një ngjarje për çdo targë, me shtetin e targës dhe llojin e mjetit. Mbështet Frigate: në një ngjarje mjeti lexon pamjen dhe e shkruan targën prapa në Frigate si nën-etiketë. Hyrja përdor OAuth, kështu që çdo përdorues merr çelësin e vet falas.

Integrimi i Home Assistant në GitHub ↗ Integrime

🔑 Hyni si zhvillues për ta provuar këtë endpoint drejtpërdrejt në sandbox — 10 thirrje testimi falas për produkt në ditë. Hyni

Përditësuar 28.10.2026 04:09