1. Документация
  2. Документация API
  3. Объект Chat

Объект Chat

Методы: Настройки чата | Создание сообщения в чате | Список сообщений | Обновление сообщения в истории чата | Удаление сообщения из истории |

init

Настройки чата

Входные параметры

Обязательные параметры:

  • String apikey (API ключ)
  • String code (Код трансляции)

Необязательные параметры:

  • Boolean enabled (Включение/Отключение чата); Принимает значения 1 и 0
  • Integer last_rows (Количество последних записей из истории чата при загрузке плеера)
  • String default_message (Сообщение, закрепленное в чате)
  • String owner_nickname (Имя администратора в чате); Не более 100 символов.
  • Boolean show_users (Отображать список пользователей в чате)

Пример запроса: 

https://boomstream.com/api/chat/init?apikey=[API_KEY]&code=XXXXXXXX&enabled=1&owner_nickname=Administrator&last_rows=10&default_message=Start%20message

Пример ответа: 

<?xml version="1.0" encoding="utf-8"?>
<Response>
    <IsEnabled>true</IsEnabled>
    <SaveNickname>true</SaveNickname>
    <ShowUsers>false</ShowUsers>
    <OwnerNickname>User</OwnerNickname>
    <LastRows>10</LastRows>
    <DefaultMessage>Message</DefaultMessage>
    <Status>Success</Status>
    <Version>1.0</Version>
    <Versions>
        <Item>
            <version>1.0</version>
            <description>Boomstream API v.1.0 loads by default</description>
        </Item>
        <Item>
            <version>1.1</version>
            <description>Boomstream API v.1.1. 
Add &amp;ver=1.1 to the HTTP request to use it. 
Change log: it is changed the response format for the method - ppv/listBuyers</description>
        </Item>
    </Versions>
    <RequestURI>/api/chat/init?apikey=286b9d5caba7ff5f013c814d0ec60a8e&amp;code=cff3vgXP&amp;enabled=1&amp;owner_nickname=User&amp;last_rows=10&amp;default_message=Message&amp;show_users</RequestURI>
</Response>

createMessage

Создание сообщения в чате

Входные параметры

Обязательные параметры:

  • String apikey (API ключ)
  • String code (Код трансляции)
  • String username (Псевдоним пользователя)
  • String message (Сообщение)

Пример запроса: 

https://boomstream.com/api/chat/createMessage?apikey=[API_KEY]&code=XXXXXXXX&username=user&message=test

Пример ответа: 

<?xml version="1.0" encoding="utf-8"?>
<Response>
    <Message>Message is created</Message>
    <Status>Success</Status>
    <Version>1.0</Version>
    <Versions>
        <Item>
            <version>1.0</version>
            <description>Boomstream API v.1.0 loads by default</description>
        </Item>
        <Item>
            <version>1.1</version>
            <description>Boomstream API v.1.1. 
Add &amp;ver=1.1 to the HTTP request to use it. 
Change log: it is changed the response format for the method - ppv/listBuyers</description>
        </Item>
    </Versions>
    <RequestURI>/api/chat/createMessage?apikey=286b9d5caba7ff5f013c814d0ec60a8e&amp;code=cff3vgXP&amp;username=usr&amp;message=Test</RequestURI>
</Response>

info

Получение списка сообщений по указанной трансляции

Входные параметры

Обязательные параметры:

  • String apikey (API ключ)
  • String code (Код трансляции)

Необязательные параметры:

  • Date start (Дата начала выборки в формате YYYY-MM-DD, например 2020-01-01); Если дата начала не указана, то период определяется как неделя с даты окончания.
  • Date end (Дата окончания выборки в формате YYYY-MM-DD, например 2020-05-01); Если дата не указана, то датой окончания является текущая дата.
  • String order (Сортировка вывода); Варианты сортировки: asc (на увеличение), desc (на уменьшение). По умолчанию asc. Поле регистроНЕзависимо.
  • Integer page (Страница вывода); По умолчанию page=1.

Пример запроса: 

https://boomstream.com/api/chat/info?apikey=[API_KEY]&code=XXXXXXXX&start=2019-01-01&end=2020-05-21&order=asc

Пример ответа: 

<?xml version="1.0" encoding="utf-8"?>
<Response>
    <Period>01.01.2021 - 01.12.2021</Period>
    <Start>01.01.2021</Start>
    <End>01.12.2021</End>
    <Page>0</Page>
    <PageLimit>1000</PageLimit>
    <PageCount>0</PageCount>
    <ItemCount>0</ItemCount>
    <ItemFormat>
        <date>Date</date>
        <code>Message code</code>
        <nickname>Nickname</nickname>
        <identity>Identity of user</identity>
        <message>Message</message>
    </ItemFormat>
    <Items/>
    <Status>Success</Status>
    <Version>1.0</Version>
    <Versions>
        <Item>
            <version>1.0</version>
            <description>Boomstream API v.1.0 loads by default</description>
        </Item>
        <Item>
            <version>1.1</version>
            <description>Boomstream API v.1.1. 
Add &amp;ver=1.1 to the HTTP request to use it. 
Change log: it is changed the response format for the method - ppv/listBuyers</description>
        </Item>
    </Versions>
    <RequestURI>/api/chat/info?apikey=286b9d5caba7ff5f013c814d0ec60a8e&amp;code=cff3vgXP&amp;start=2021-01-01&amp;end=2021-12-01&amp;order=asc&amp;page</RequestURI>
</Response>

updateMessage

Обновление сообщения в истории чата

Входные параметры

Обязательные параметры:

  • String apikey (API ключ)
  • String code (Код трансляции)
  • String code_message (Код сообщения)
  • String message (Сообщение)

Пример запроса: 

https://boomstream.com/api/chat/updateMessage?apikey=[API_KEY]&code=XXXXXXXX&code_message=[CODE_MESSAGE]&message=update

Пример ответа: 

<?xml version="1.0" encoding="utf-8"?>
<Response>
    <date>2021-11-03 11:23:54</date>
    <codeMessage>MZDupnoSVWYDW77jnWrKQCmAiRA7aSqb</codeMessage>
    <nickname>1</nickname>
    <identity>admin@boomstream.com</identity>
    <isOwner>false</isOwner>
    <Status>Success</Status>
    <Version>1.0</Version>
    <Versions>
        <Item>
            <version>1.0</version>
            <description>Boomstream API v.1.0 loads by default</description>
        </Item>
        <Item>
            <version>1.1</version>
            <description>Boomstream API v.1.1. 
Add &amp;ver=1.1 to the HTTP request to use it. 
Change log: it is changed the response format for the method - ppv/listBuyers</description>
        </Item>
    </Versions>
    <RequestURI>/api/chat/updateMessage?apikey=286b9d5caba7ff5f013c814d0ec60a8e&amp;code=cff3vgXP&amp;code_message=MZDupnoSVWYDW77jnWrKQCmAiRA7aSqb&amp;message=upd</RequestURI>
</Response>

deleteMessage

Удаление сообщения в чате

Входные параметры

Обязательные параметры:

  • String apikey (API ключ)
  • String code (Код трансляции)
  • String code_message (Код сообщения)

Пример запроса: 

https://boomstream.com/api/chat/deleteMessage?apikey=[API_KEY]&code=XXXXXXXX&code_message=[CODE_MESSAGE]

Пример ответа: 

<?xml version="1.0" encoding="utf-8"?>
<Response>
    <Message>Chat message is removed from history</Message>
    <Status>Success</Status>
    <Version>1.0</Version>
    <Versions>
        <Item>
            <version>1.0</version>
            <description>Boomstream API v.1.0 loads by default</description>
        </Item>
        <Item>
            <version>1.1</version>
            <description>Boomstream API v.1.1. 
Add &amp;ver=1.1 to the HTTP request to use it. 
Change log: it is changed the response format for the method - ppv/listBuyers</description>
        </Item>
    </Versions>
    <RequestURI>/api/chat/deleteMessage?apikey=286b9d5caba7ff5f013c814d0ec60a8e&amp;code=cff3vgXP&amp;code_message=MZDupnoSVWYDW77jnWrKQCmAiRA7aSqb</RequestURI>
</Response>