Көрсетілімдерді импорттау

Өз CMS жүйесін жүргізетін операторлар ол санаған көрсетілімдерді жібере алады. Платформа оларды ойнатқыштар хабарлайтын көрсетілімдердің жанында сақтайды және екеуін әр түнде салыстырады.

Бастамас бұрын

Оператор ұйымының әкімшісі жасаған write:plays рұқсаты бар API кілті керек. Аутентификация және API кілттері бөлімін қараңыз.
Әр жол ұйымыңыздың құрылымын және оны қамтитын келісуді атайды.

Пакетті жіберу

curl -X POST 'https://app.tanba-ooh.kz/api/v1/plays/import' \
  -H 'Authorization: Bearer tnbk_EXAMPLE_secret' \
  -H 'Content-Type: text/csv' \
  --data-binary @plays.csv

Дене JSON ({"rows": [...]}) немесе тақырып жолы бар CSV болады: UTF-8, үтір немесе нүктелі үтір, көбі 5 МБ немесе 50 000 жол.

structure_code,approval_number,hour,plays,source_ref
ALM-0012,TNB-2026-000123,2026-10-06T14:00:00+05:00,118,cms-main
ALM-0012,TNB-2026-000123,2026-10-06T15:00:00+05:00,120,cms-main

Баған	Мағынасы
`structure_code` немесе `structure_id`	Құрылым; екеуінің бірін көрсетіңіз
`approval_number`	Күшінде болған келісу
`hour`	ISO 8601 пішімінде толық сағат. Ығысусыз Asia/Almaty уақыты ретінде оқылады
`plays`	Материал сол сағатта неше рет көрсетілді
`source_ref`	Көзіңіздің міндетті емес атауы, 100 таңбаға дейін

Жауапты оқу

Жолдар бір-бірден бағаланады. Жауапта әр жол accepted немесе refused болып белгіленеді, бас тартуға себеп коды беріледі. Қабылданған жолдар пакеттегі басқалары қабылданбаса да сақталады. Қабылданбаған жолдарды түзетіп, тек соларды қайта жіберіңіз.

Жолды қайта жіберу

Жол (ұйым, құрылым, келісу, сағат, source_ref) кілтімен сақталады. Оны қайта жіберу алдыңғы мәнді ауыстырады және ешқашан оған қосылмайды. source_ref мәндері әртүрлі жолдар бөлек сақталады және салыстыру кезінде қосылады. Бір көзге бір source_ref беріңіз және оны өзгертпеңіз.

Импортталған көрсетілімдер деген не

Импортталған көрсетілімдер дәлел болмайды. Олар ойнатқыштар хабарлайтын көрсетілімдерден бөлек сақталады, ешқашан есептеулерге кірмейді және бақылау оқиғасын ешқашан анықтамайды. Платформа оларды әр түнде ойнатқыштар есептерімен салыстырады. Ойнатқыштардың есебі мен сіздің импортыңыз 10 %-дан артық айырмашылықта болса, құрылым үшін import_mismatch оқиғасы ашылады. Салыстыруды операциялық есептен оқуға болады.

Себеп кодтары

Толық тізім «Көрсетілімдерді импорттау» анықтамалық бетінде берілген.