> For the complete documentation index, see [llms.txt](https://doc.waix.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.waix.ru/site/news.md).

# Новости

## Получение списка новостей

<mark style="color:blue;">`GET`</mark> `https://api.waix.ru/site/news`

Список будет сформирован от более новых к более старым, по умолчанию выводится 5 новостей, но вы можете запросить любое число от 1 до 100. Содержание новости будет сокращено до 20 слов, вы так же можете указать сокращение содержания слов от 10 до 100. Значение `words=0` отключает вывод содержимого новости. Все html теги в содержании новости будут удалены

#### Query Parameters

| Name                                                      | Type   | Description                                                                                                                               |
| --------------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| token or key or project<mark style="color:red;">\*</mark> | String | Серверный или клиентский [токен](/access.md#klyuch-token), [ключ-доступа](/access.md#klyuch-kod) или номер [проекта](/expand/projects.md) |
| count                                                     | int    | количество новостей, по умолчанию 5                                                                                                       |
| offset                                                    | int    | Выводит записи с отступом (т.е кроме n первых записей)                                                                                    |
| words                                                     | int    | Указывает сколько слов должно содержаться в кратком выводе содержимого новости. Допустимо от нуля до 100 слов в новости.                  |

{% tabs %}
{% tab title="200: OK Выводится список новостей" %}

{% endtab %}
{% endtabs %}

## Получение содержимого новости

<mark style="color:blue;">`GET`</mark> `https://api.waix.ru/site/news/{id}`

Ответ будет содержать новость «как есть», с выборочным сохранением тегов:

```html
<br> <b> <i> <u> <a> <strong> <em> <span>
```

#### Любые стили внутри тегов будут удалены перед выдачей, но по прежнему сохранены в системе

#### Path - (/параметр/параметр)

| Name                                 | Type | Description                                                                          |
| ------------------------------------ | ---- | ------------------------------------------------------------------------------------ |
| id<mark style="color:red;">\*</mark> | Int  | Идентификатор новости из [списка новостей](/site/news.md#poluchenie-spiska-novostei) |

#### Query - (ключ=значение&ключ=значение)

| Name                                                      | Type   | Description                                                                                                                               |
| --------------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| token or key or project<mark style="color:red;">\*</mark> | String | Серверный или клиентский [токен](/access.md#klyuch-token), [ключ-доступа](/access.md#klyuch-kod) или номер [проекта](/expand/projects.md) |

{% tabs %}
{% tab title="200: OK Выводится содержимое новости" %}

```json
{
    "status": "OK",
    "result": {
        "title": "Курс 14.1 = 1 юань", // заголовок новости
        "content": "<span>Уважаемые клиенты 30.09.2025 года курс на нашем сайте равен 14. 1 руб за 1 юань . Все новые зачисления принимаем по актуальному курсу</span>", // её описание с сохранением некоторых тегов
        "image": "https://d.zaix.ru/IIJz.png", // фото, с 2022 г фото выдаются с хостинга zaix.ru и могут использовать для сжатия налету: например https://d.zaix.ru/IIJz.png_c80x80.webp для создания квадратного обрезанного в центре изображения
        "date_create": 1727669591, // дата создания, время когда новость была создана
        "date_public": 1727643600, // дата публикации, время после которого новость будет доступна
        "date": "30 сен 2025" // удобочитаемый формат
    }
}
```

{% endtab %}
{% endtabs %}