# Объекты уведомлений API Callback

Описание

В данном разделе описаны структуры данных, отправляемые API Callback на заданный вами Callback URL.

# Объект уведомления о выходе новой публикации в канале или сообщения в чате

{
    "subscription_id": 1234,          # ID подписки, для которой наступило событие
    "subscription_type": "channel",   # Тип подписки
    "event_id": 843968,               # ID события
    "event_type": "new_post",         # Тип события (в данном случае - "выход новой публикации в канале")
    "post": Post,                     # Объект с полными данными о публикации {Post}
    "channels": [                     # Массив объектов каналов {Channel}, которые присутствуют в объекте post 
        Channel,                   
        ...
    ],
    "users": [                        # Массив пользователей {User}, которые встречаются в объекте post
        User,                         # (присутствует, если post является сообщением в чате)
        ...
    ],
}

Объекты событий edit_post и remove_post

Для типов событий event_type = edit_post (редактирование) и event_type = remove_post (удаление), структура объекта полностью идентична, за исключением того, что параметр event_type будет иметь значение, соответствующее текущему событию.

Структуры объектов Post, Channel и User подробно описаны на страницах "Объект публикации Post", "Объект канала Channel" и "Объект пользователя User" настоящей документации.

# Пример кода на языке PHP для получения уведомлений от TGStat API Callback

<?php

$json = file_get_contents('php://input');
$dataArray = json_decode($json, true);

file_put_contents("callback.log", print_r($dataArray, true) . "\n\n", FILE_APPEND);

# Пример уведомления о выходе новой публикации в Telegram-канале "Караульный"

{
    "subscription_id":10306,
    "subscription_type":"channel",
    "event_id":848132,
    "event_type":"new_post",
    "post":{
        "id":9357973251,
        "date":1571911771,
        "views":36,
        "link":"t.me/karaulny/179385",
        "channel_id":2321,
        "forwarded_from":1151872,
        "is_deleted":0,
        "text":"Количество заключаемых в последнее время РЖД соглашений на развитие железнодорожных сетей в других странах (вот и на африканском форуме в Сочи посыпались как из рога изобилия: Нигерия, Египет, Конго, Ангола...) вынуждает настойчиво поинтересоваться, когда Белозеров успеет всё это реализовать? С учетом того, что в самой России - работы не початый край и квалифицированных кадров не хватает.                
                Нет, нам на самом деле любопытно. Мы за экспансию и международные контракты. Но, черт возьми, как, Холмс?!",
        "media":{
            "media_type":"mediaPhoto",
            "caption":""
        }
    },
    "channels":[
        {
            "id":2321,
            "link":"t.me/karaulny",
            "username":"@karaulny",
            "title":"Караульный",
            "about":"Медиа - наша рефлексия. Для связи - @karaulka",
            "image100":"//static10.tgstat.ru/channels/_100/76/761c7920f470038d4c8a619c79eddd62.jpg",
            "image640":"//static10.tgstat.ru/channels/_0/76/761c7920f470038d4c8a619c79eddd62.jpg",
            "participants_count":103114
        },
        {
            "id":1151872,
            "link":"t.me/gruz0potok",
            "username":"@gruz0potok",
            "title":"Грузопоток",
            "about":"Всё о перевозках грузов по железной дороге в России и ближайшем зарубежье",
            "image100":"//static10.tgstat.ru/channels/_100/ac/acd208d41994c057680e9584e3d73dfc.jpg",
            "image640":"//static10.tgstat.ru/channels/_0/ac/acd208d41994c057680e9584e3d73dfc.jpg",
            "participants_count":11966
        }
    ]
}

# Пример уведомления о новом сообщении в Telegram-чате "@tutby_news_chat"

{
    "subscription_id":10306,
    "subscription_type":"channel",
    "event_id":848132,
    "event_type":"new_post",
    "post":{
        "id":13884852683,
        "date":1603693772,
        "views":null,
        "link":"t.me/tutby_news_chat/439029",
        "channel_id":2098588,
        "forwarded_from":null,
        "is_deleted":0,
        "text":"Всем привет",
        "media":null,
        "user_id":8046254608
    },
    "channels":[
        {
            "id":2098588,
            "link":"t.me/tutby_news_chat",
            "username":"@tutby_news_chat",
            "title":"TUT.BY новости — Чат",
            "about":"Это @tutby_news_chat, чат TUT.BY о новостях ...",
            "image100":"//static10.tgstat.ru/channels/_100/d8/d85127fd74a5bdce25eda565e83beb92.jpg",
            "image640":"//static10.tgstat.ru/channels/_0/d8/d85127fd74a5bdce25eda565e83beb92.jpg",
            "participants_count":13851,
            "tgstat_restrictions": {
            
            }
        }
    ],
    "users":[
        {
            "id":8046254608,
            "tg_id":1301897236,
            "username":"@idispatch97",
            "firstname":"Иван",
            "lastname":"Петров"
        }
    ]
}