Слање вести и флота NakBus сада су на партнерској табли

Koristite iste podatke za prijavu (e-adresu i lozinku) kao za nalog programera da biste se prijavili na panel Nakordoni Partners i tamo upravljali vestima i vašim autobuskim voznim parkom (NakDriver / NakManager), uz timske uloge. Vaši API ključevi, krajnje tačke i aplikacije ostaju nepromenjeni, a stranice ovde i dalje rade. Отвори Nakordoni Partners

API за препознавање регистарских таблица (ALPR / ANPR) Online

Чита регистарске таблице на фотографији возила. Пошаљите POST-ом једну слику (JPEG, PNG, WebP, BMP или TIFF, највише 8 MB) као JSON тело са image_url или image_base64, као multipart/form-data отпремање у пољу „image“, или као сирове бајтове са image/* Content-Type. Свака пронађена таблица враћа се са текстом, оценом 0-1, алтернативним читањима, оквиром таблице у пикселима и оценом детекције. Мотор је наш сопствени детектор и читач таблица, подешен на европским камионима и аутобусима. Слике се обрађују у меморији и никада се не чувају. image_url мора бити јавна http(s) адреса; приватне и интерне адресе, као и преусмеравања на њих, одбијају се, а преузимање се прекида после 10 секунди.

POST https://nakordoni.eu/api/v2/data/plate-recognition — класа квоте: heavy

Параметар	Опис
`image_url`	(JSON тело) Јавни http(s) URL слике. Највише 8 MB, највише 3 преусмеравања, ограничење преузимања 10 s.
`image_base64`	(JSON тело) Слика као base64 (дозвољен је префикс data:image/...;base64,). Пошаљите image_url или image_base64, не оба.

Поља одговора — унутар објекта data у коверти одговора. [] означава листу, па је data.items[].name поље name сваког елемента. Поље је null, недостаје или је празна листа када немамо вредност — никада не убацујемо замену.

Поље	Опис
`data.success`	true када је прочитана бар једна таблица; data.message наводи колико их је.
`data.processing_time`	Време утрошено на захтев у милисекундама (преузимање и препознавање).
`data.results[]`	Један унос по таблици, прво она са највећом оценом детекције.
`data.results[].plate`	Текст таблице, великим словима, само слова A-Z и цифре (без размака и цртица).
`data.results[].score`	Поузданост читања 0-1 (средња вредност поузданости по знаку).
`data.results[].candidates[]`	До 5 читања {plate, score}, најбоље прво; прво је таблица.
`data.results[].region`	{code, score} са државом таблице када је мотор може одредити; иначе null (тренутни мотор не закључује државу).
`data.results[].box`	Положај таблице у пикселима: xmin, ymin, xmax, ymax.
`data.results[].dscore`	Поузданост детекције таблице 0-1.
`data.results[].vehicle`	Подаци о возилу када су доступни; null са тренутним мотором.
`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"
}'

У поређењу са V1: нови параметри regions, camera_id, timestamp, config, threshold, mode

Шта је другачије у овој верзији: v4 попуњава два поља која v2 увек враћа као null. results[].region даје државу таблице као {code, score}, на основу формата таблице: распореда слова и цифара сваке државе и, где формат то има, префикса региона или округа (на пример CE на украјинској таблици). results[].vehicle даје возило које носи таблицу као {type, score, box}, из нашег детектора возила: type је car, bus, truck или motorcycle. v4 прихвата и опционе опције захтева: regions, camera_id, timestamp, config.threshold и config.mode. Без њих излаз v4 се не мења. Остала поља одговора и кодови грешака из v2 исти су. v2 и даље враћа null за оба поља и игнорише опције.

POST https://nakordoni.eu/api/v4/data/plate-recognition — класа квоте: heavy

Параметар	Опис
`image_url`	(JSON тело) Јавни http(s) URL слике. Највише 8 MB, највише 3 преусмеравања, ограничење преузимања 10 s.
`image_base64`	(JSON тело) Слика као base64 (дозвољен је префикс data:image/...;base64,). Пошаљите image_url или image_base64, не оба.
`regions`	Опционо. Државе које очекујете, као ISO 3166-1 alpha-2 кодови: JSON низ ["PL","DE"] или стринг одвојен зарезима "PL,DE" (multipart поље или query параметар). До 10. Процена региона и редослед читања naginju ка овим државама: када најбоље читање не одговара формату ниједне наведене државе, а други кандидат са оценом највише 0,15 нижом одговара, тај кандидат постаје таблица. Таблица која не одговара ниједној наведеној држави задржава уобичајени одговор.
`camera_id`	Опционо. ID ваше камере или капије, до 128 знакова. Враћа се непромењен у data.camera_id. Не чува се изван уобичајеног логa захтева.
`timestamp`	Опционо. Време снимања у вашем формату (на пример 2026-10-27T14:05:00Z), до 64 знака. Враћа се непромењено у data.timestamp. Не чува се изван уобичајеног логa захтева.
`config`	Опционо. JSON објекат {"threshold": 0-1, "mode": "fast"\|"full"}. У multipart форми или query стрингу пошаљите га као JSON стринг или користите поља threshold и mode.
`threshold`	Опционо, исто као config.threshold. Резултати са score испод ове вредности (0-1) изостављају се. Када ниједан не остане, одговор је 404 no_plate_detected.
`mode`	Опционо, исто као config.mode. full (подразумевано) покреће препознавање таблице и детекцију возила. fast прескаче детекцију возила ради брзине сличне v2: region се и даље попуњава, vehicle је null.

Поље	Опис
`data.success`	true када је прочитана бар једна таблица; data.message наводи колико их је.
`data.processing_time`	Време потрошено на захтев у милисекундама (преузимање, препознавање таблице и детекција возила). v4 траје дуже од v2 због детекције возила, обично 0,5-1,5 s по слици. Са config.mode=fast нема детекције возила и време је блиско v2.
`data.camera_id`	camera_id који сте послали, непромењен. Присутан само када сте га послали.
`data.timestamp`	timestamp који сте послали, непромењен (стринг остаје стринг, број остаје број). Присутан само када сте га послали.
`data.results[]`	Један унос по таблици, прво она са највећом оценом детекције.
`data.results[].plate`	Текст таблице, великим словима, само слова A-Z и цифре (без размака и цртица).
`data.results[].score`	Поузданост читања 0-1 (средња вредност поузданости по знаку).
`data.results[].candidates[]`	До 5 читања {plate, score}, најбоље прво; прво је таблица.
`data.results[].region`	{code, score}: code је ISO 3166-1 alpha-2 држава таблице (на пример UA, PL, RO), одређена на основу формата таблице. score 0-1 је поузданост читања помножена специфичношћу формата; када се исти формат користи у више држава (на пример LT, MD и HU деле ABC123) оцена се дели међу њима и ниска је. null када текст не одговара ниједном познатом формату. Покривено: UA, BG, BY, RO, ES, CZ, BE, EE, HU, TR, PL, SK, LV, LT, MD, IT, FR, RS, DE.
`data.results[].box`	Положај таблице у пикселима: xmin, ymin, xmax, ymax.
`data.results[].dscore`	Поузданост детекције таблице 0-1.
`data.results[].vehicle`	{type, score, box}: возило које носи таблицу. type је car, bus, truck или motorcycle; score је поузданост детекције 0-1; box је положај возила у пикселима (xmin, ymin, xmax, ymax). Аутобуси гледани спреда и мини-бусеви или комбији могу бити означени као truck (детектор нема класу van). null када ниједно детектовано возило не садржи таблицу, и увек null са 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 (и када config.threshold не остави ниједан резултат). 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
    }
}'

Препознавање регистарских таблица (ANPR / ALPR) за европска возила

Plate Image Recognition API је сервис за препознавање регистарских таблица (LPR): пошаљете фотографију и као JSON добијете текст таблице. То је наш сопствени ANPR / ALPR алат, подешен на камионима и аутобусима из ЕУ на граничним прелазима и аутобуским депоима, а чита и таблице аутомобила и мотоцикала.

Верзија v4 додаје државу таблице и тип возила (car, bus, truck или motorcycle). Прихвата и опционе опције захтева: regions, да резултат нагне ка државама које очекујете; camera_id и timestamp, који се враћају у одговору; праг оцене; и fast режим.

GDPR већ у дизајну: API је хостован у ЕУ, а свака слика се обрађује само у меморији и никада се не чува. Ниједан спољни сервис за обраду слике не види ваше слике.

Интеграције: Home Assistant

Наша open-source интеграција за Home Assistant (MIT лиценца, инсталира се преко HACS) чита регистарске таблице са ваших Home Assistant камера. Даје сензор и догађај за сваку таблицу, са државом таблице и типом возила. Подржава Frigate: на догађај возила чита снимак и уписује таблицу назад у Frigate као подоознаку. Пријава користи OAuth, па сваки корисник добија свој бесплатан кључ.

Home Assistant интеграција на GitHub-у ↗ Интеграције

🔑 Пријавите се као програмер да бисте овај endpoint испробали уживо у sandbox-у — 10 бесплатних тест позива по производу дневно. Пријава

Ažurirano 28.10.2026 04:08