mila/protocol.md

BVK Exchange Protocol

Based on Протокол_обмена_медиакомплекса_и_БВК.pdf.

Role

• BVK is the HTTP client.
• Media complex is the HTTP server.
• Default address from the document: 172.16.16.2:13280.

Set Content

GET /set-content?route=<R>&str=<S>&tpl_name=<T>

Parameters are URL-encoded.

Parameter	Meaning
route	Route number, 1 to 3 characters
str	Ticker/running text
tpl_name	Media content template name

Current library defaults:

Field	Default limit
route	3 characters
str	200 characters
tpl_name	200 characters

The exact text/template limits must be confirmed with the integrator because the PDF text layer is ambiguous for the original value.

Get Content

GET /get-content

Response:

{
  "route": "<R>",
  "str": "<S>",
  "tpl_name": "<T>"
}

Mila keeps updated_at internally, but the HTTP response is strict and exposes only the fields defined by the protocol.

Status Codes

Code	Meaning
200	OK
400	Bad request / validation error
404	Path not found
500	Internal server error
503	State is not ready or dependency unavailable