1. ObjectLabel
VueronTechnology
EN
  • EN
  • KR
  • EN-previous
  • KR-previous
  • Vueron VueFlow Operation Manual
  • How to Install Oslo Client
  • VueFlow PCD Calibration Guide
  • Mbembo
    • User
      • UserLogin
      • RefreshToken
    • Statistics
      • Get Zone Statistics
      • Get Zone Statistics Client
      • Get Slot Statistics
      • Get Zone Inter Statistics
      • Get Zone Trail Statistics
    • Event
      • Stream Area Frame
      • Stream Event
    • AlarmLog
      • Get AlarmLog Count
      • Get AlarmLog List
    • ObjectLabel
      • Register Object Labels
        POST
      • Get Object Label List
        GET
      • Delete Object Label
        DELETE
    • ObjectTrajectory
      • Get Object Trajectory List
  1. ObjectLabel

Register Object Labels

POST
{{mbembo_url}}/api/v1/mbembo/object/label
Registers operator-assigned display labels keyed by object id. The body is always a JSON array of ObjectLabel; send a single label as a one-element array. Registration is an upsert: an existing object id gets its label replaced and its timestamps reset.
Once registered, the label is injected into MZVObject.label just before every publish (WebSocket area push and GET /object in MZ mode). It is a display-only derived value: kept in memory, lost on restart, never persisted to DB. Playback frames are not labeled.
Lifetime
A label is bound to the object id's lifetime. When the track expires and the same physical object gets a new id, it must be registered again (no re-identification).
A mapping that the injection path has not referenced for object_label.stale_sec (default 600s) expires and disappears from GET /object/label. Each successful injection resets the TTL, so a label never expires while its object is being published.
Constraints (validated by ObjectLabels.Validate)
The array must not be empty and may hold at most object_label.max_entries (default 1000) elements.
No null elements. objectID is required and must be unique within the batch.
label is required, 1-20 characters (runes), no leading/trailing spaces, allowed characters: Korean (syllables and jamo), letters, digits, space, - _ . , ( ) # /. Control characters, emoji and < > are rejected.
registeredAt and lastReferencedAt are server-owned; values sent by the client are discarded.
Validation reports every problem at once, joined with "; " (e.g. labels[0]: objectID is required; labels[1]: label exceeds 20 characters), so a rejected request can be fixed in one pass.
Capacity: after counting the new ids, the total stored mappings may not exceed object_label.max_entries; a batch that would exceed it is rejected whole (no partial registration).
The endpoints stay registered even when object_label.enable=false; that flag only stops the injection into published objects.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/jsonRequired

Examples

Responses

🟢200OK
application/json
Labels registered (upsert). resultData echoes the batch with server-assigned registeredAt/lastReferencedAt.
Bodyapplication/json

🟠400Bad Request
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --globoff '{{dev_mbembo_url}}/api/v1/mbembo/object/label' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '[
    { "objectID": "1-10923", "label": "지게차 A" }
]'
Response Response Example
200 - Success
{
  "trID": "20261006141205331001",
  "resultCode": "0200",
  "resultMsg": "RegisterObjectLabels OK",
  "resultData": [
    {
      "objectID": "1-10923",
      "label": "지게차 A",
      "registeredAt": "2026-10-06T14:12:05.331Z",
      "lastReferencedAt": "2026-10-06T14:12:05.331Z"
    }
  ]
}
Modified at 2026-10-06 06:41:35
Previous
Get AlarmLog List
Next
Get Object Label List
Built with