# get

Получение списка ботов.

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

| **Параметр**                                               | Описание                                                                                                                           |                                                               |
| ---------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
| <p><strong>count</strong> <br><em>(int)</em></p>           | <p>количество элементов, информацию о которых нужно вернуть</p><p>максимум: <code>100</code></p><p>пример: <code>50</code></p>     |                                                               |
| <p><strong>offset</strong> <br><em>(int)</em></p>          | <p>смещение - с какого количества элементов нужно сделать выборку</p><p>по умолчанию: <code>0</code>                               | максимум: <code>100 000</code><br>пример: <code>50</code></p> |
| <p><strong>bot\_id</strong><br><em>(array)</em></p>        | <p>идентификаторы ботов<br>пример: <code>\[123]</code></p>                                                                         |                                                               |
| <p><strong>tag\_id</strong> </p><p><em>(int)</em></p>      | <p>идентификатор тега. Возвращает только ботов, у которых есть тег с указанным <code>tag\_id</code><br>пример: <code>2</code></p>  |                                                               |
| <p><strong>tag\_value</strong></p><p><em>(string)</em></p> | <p>Значение тега. Возвращает только ботов, у которых есть тег со значением <code>tag\_value</code><br>пример: <code>wew</code></p> |                                                               |

Ответ:&#x20;

| **Параметр**                                        | Описание                                                                                               |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| <p><strong>success</strong> <br><em>(bool)</em></p> | <p><code>true</code> - операция прошла успешно</p><p><code>false</code> - при возникновении ошибки</p> |
| <p><strong>count</strong> <br><em>(int)</em></p>    | <p>количество всех элементов в выборке <br>пример: <code>20</code></p>                                 |
| <p><strong>items</strong> <br><em>(array)</em></p>  | массив ботов                                                                                           |

Структура бота:

| **Параметр**                                            | Описание                                                                                                                                         |
| ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| <p><strong>bot\_id</strong> <br><em>(int)</em></p>      | <p>идентификатор бота</p><p>пример: <code>453754</code></p>                                                                                      |
| <p><strong>title</strong> <br><em>(string)</em></p>     | <p>название бота</p><p>пример: <code>Тест</code></p>                                                                                             |
| <p><strong>date</strong> <br><em>(string)</em></p>      | <p>дата и время создания бота<br>формат: <code>d.m.Y H:i:s</code> пример: <code>27.11.2018 10:00:00</code></p>                                   |
| <p><strong>active</strong> <br><em>(int)</em></p>       | <p>Статус бота</p><p><code>0</code> Остановлен</p><p><code>1</code> Запущен</p><p>пример: <code>0</code></p>                                     |
| <p><strong>published</strong> <br><em>(int)</em></p>    | <p>Статус публикации бота</p><p><code>0</code> Есть неопубликованные изменения</p><p><code>1</code> Опубликован</p><p>пример: <code>0</code></p> |
| <p><strong>tags</strong> </p><p><em>(array)</em></p>    | Массив тегов бота. Если у бота нет тегов - возвращается пустой массив `[]`                                                                       |
| <p><strong>tag\_id</strong></p><p><em>(int)</em></p>    | <p>Идентификатор тега</p><p>пример: <code>2</code></p>                                                                                           |
| <p><strong>value</strong></p><p><em>(string)</em></p>   | <p>Значение тега<br>пример: <code>wew</code></p>                                                                                                 |
| <p><strong>entity\_id</strong></p><p><em>(int)</em></p> | <p>Идентификатор бота, к которому привязан тег<br>пример: <code>86</code></p>                                                                    |
