Онлайн видео платформа. Сервис Бумстрим | Boomstream.
Открыть в API Explorer

Работа с API

API методы
функционал

Методы: info

Общая информация по АПИ

API-ключ проекта находится в настройках личного кабинета, в разделе «Интеграция».

Boomstream API использует протокол взаимодействия REST. Префикс API:

Text 
https://boomstream.com/api/

Все входные данные передаются через GET-параметры. Форматы выходных данных: json и xml.

Формат задаётся с помощью параметра format. Примеры:

Text 
https://boomstream.com/api/info?apikey=[API_KEY]&format=xml&ver=1.2
https://boomstream.com/api/info?apikey=[API_KEY]&format=json&ver=1.2
https://boomstream.com/api/info?apikey=[API_KEY]&format=xls&ver=1.2 [experimental]

Версии API

  • Версия API по умолчанию — 1.0

    • Boomstream API v.1.0 loads by default

  • Промежуточная версия API — 1.1

    • Changed the response format for the method ppv/listBuyers

  • Текущая версия API — 1.2

    • changed the response format for methods ppv/listMedia and ppv/addMedia

Чтобы использовать текущую версию API, необходимо передать HTTP-параметр ver — &ver=1.2.

Формат ответа

Каждый ответ API содержит параметр Status, который указывает на статус выполнения запроса. Успешные запросы имеют статус Success, неуспешные — Failed. Кроме того, ответы с ошибкой содержат дополнительный параметр Message с текстом ошибки.

info

Get additional information about media by its code

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

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

  • String apikey (АПИ ключ проекта)

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

  • String Success (Статус ответа)

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

Text 
https://boomstream.com/api/info?apikey=[API_KEY]

Пример успешного ответа:

XML 
<Response>
    <Status>Success</Status>
    <sections>
        <section>
            api/media
        </section>
        ...
    </sections>
    <Version>1.1</Version>
    <Versions>
        <Item>Boomstream API v.1.0 is loaded by default</Item>
        <Item>
            Boomstream API v.1.1. Add &ver=1.1 to the HTTP request to use it. Change log: it is changed the response format for the method - ppv/listBuyers
        </Item>
    </Versions>
</Response>

Пример ответа с ошибкой:

XML 
<Response>
    <Message>Method not found</Message>
    <Status>Failed</Status>
    <Version>1.1</Version>
</Response>

Классы API

Ниже представлены классы для работы с API: