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

За да се најавите на панелот Nakordoni Partners, користете ги истите податоци за најава (е-пошта и лозинка) како за вашата сметка на програмер, и таму управувајте со вестите и со вашиот автобуски возен парк (NakDriver / NakManager), со тимски улоги. Вашите API-клучеви, крајни точки и апликации остануваат непроменети, а страниците овде продолжуваат да работат. Отвори Nakordoni Partners

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

Ги чита регистарските таблички на фотографија од возило. Испратете POST со една слика (JPEG, PNG, WebP, BMP или TIFF, макс. 8 MB) како JSON тело со image_url или image_base64, како качување multipart/form-data во полето "image", или како суровите бајти со заглавие Content-Type image/*. Секоја пронајдена табличка се враќа со текстот, оценка 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 поле или параметар во барањето). До 10. Претпоставката за регионот и редоследот на читање се насочуваат кон овие држави: кога најдобриот резултат не одговара на формат на ниту една наведена држава, а друг кандидат со најмногу 0.15 помал score одговара, тој кандидат станува таблицата. Таблица што не одговара на ниту една наведена држава го задржува вообичаениот одговор.
`camera_id`	Опционално. ID на вашата камера или рампа, до 128 знаци. Се враќа непроменет во data.camera_id. Не се чува надвор од вообичаениот лог на барања.
`timestamp`	Опционално. Времето на снимање во ваш формат (на пример 2026-10-27T14:05:00Z), до 64 знаци. Се враќа непроменето во data.timestamp. Не се чува надвор од вообичаениот лог на барања.
`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 (стандардно) вршi препознавање на таблица и детекција на возило. 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 (детекторот нема класа комбе). 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 engine, прилагоден на ЕУ камиони и автобуси на гранични премини и во автобуски депоа. Чита и таблици од автомобили и мотоцикли.

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

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

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

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

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

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

Ажурирано 28.10.2026 04:09