TAŇBA-OOH Әзірлеушілерге

CMS жүйесін қосу

Коммерциялық CMS жүйесі CMS профилі бойынша (C1 және C2 деңгейлері) сертификатталғаннан кейін TAŇBA-OOH құрылымдарын басқара алады. Бұл нұсқаулық ол жасайтын үш шақыруды және ешқашан бұзбауы тиіс бір ережені сипаттайды. Талаптардың толық тізімі CMS профилі құжатында.

Консольде бір рет тіркеу

Оператор ұйымының әкімшісі мұны Integrations бөлімінде жасайды:

  1. Орнатым үшін қол қою көзін тіркейді (атауы, түрі және CMS жүйесінің ECDSA P-256 ашық кілті). Бір көз бір орнатымға қызмет етеді.
  2. Орнатымды тіркейді: көз, сертификатталған өнімнің сертификат нөмірі, қолданыстағы нұсқа, базалық мекенжай және ол қай жерде орналасқаны туралы мәлімдеме.
  3. CMS жүйесінің әр ойнатқышын бір құрылымға байланыстырады және әр құрылымды орнатыммен байланыстырады.
  4. relay:commands рұқсаты бар API кілтін, ал көрсетілімдер үшін write:plays рұқсатын жасайды.

Қол қойылған командаларды алу

curl 'https://app.tanba-ooh.kz/api/v1/cms/commands?installation=5d0c8e7a-21b4-4c3f-9a6e-0b1d2c3e4f50&wait=30' \
  -H 'Authorization: Bearer tnbk_EXAMPLE_secret'

Оны wait=30 параметрімен циклде немесе device_command.issued вебхугі бойынша шақырыңыз. Әр элементте команда, ол қолданылатын құрылымдар және қол қойылған конверт бар. Платформа конвертті командалар түбірлері бойынша тексеріп қойған; CMS жүйесі де оны тексеруі керек. Команданы алғаннан кейін 60 секунд ішінде тізімдегі әр құрылымның ойнатқыштарында орындаңыз, содан кейін әр құрылымды растаңыз:

curl -X POST 'https://app.tanba-ooh.kz/api/v1/cms/commands/01a1377e-c8e3-7c41-8ae9-3a8dc9413fbd/acks?installation=5d0c8e7a-21b4-4c3f-9a6e-0b1d2c3e4f50' \
  -H 'Authorization: Bearer tnbk_EXAMPLE_secret' -H 'Content-Type: application/json' \
  -d '{"structure": "ALM-0012", "ok": true, "state": "blackout"}'

Расталмаған команда 5 минуттан кейін қайта беріледі және үшінші әрекеттен кейін сәтсіз деп белгіленеді. Платформа нәтижені ретрансляцияланған, бірақ құрылғыда тексерілмеген деп көрсетеді.

switch кілті уәкілетті органға тиесілі

Өшіру ойнатқыштың switch кілтіне blackout мәнін жазады, қалпына келтіру default мәнін жазады, ал шұғыл хабар тарату немесе мазмұнды ауыстыру сценарий атауын жазады. switch кілтіне тек ретрансляцияланған командаларды орындайтын код жаза алады. CMS жүйесінің басқа ешбір функциясы (жалғастыру, кідірту, жариялау, өзінің өшіруі немесе шұғыл режимі, қайта іске қосу) оған жаза алмайды және өшіруді алып тастай алмайды. Мұны жасайтын CMS сертификатталмайды.

Көрсетілімдерді жіберу

Көрсетілімдер write:plays рұқсатымен және орнатым көзінің кілтімен жасалған қолтаңбамен POST /api/v1/pop/batches қол қойылған пакеттер арнасына жіберіледі. Пакет пішімі көрсетілімдерді есепке алу анықтамалығында. Мұндай көрсетілімдер куәландырылған: оларды оператордың жүйесі хабарлап, қол қойған, бірақ құрылғыда көрілмеген.