Гайды
Поиск новостей v200.1.0
Как получить список новостей с фильтрами: GET /post/ и GET /table/post/.
Нужно найти опубликованные новости из категории или с определённым доп. полем — этот гайд. Создание — posts-create.
Что нужно заранее
- Bearer — auth
- Scope read на
post— access-levels - Как устроены адреса — endpoints
Два URL списка
| URL | Отличие |
|---|---|
GET /post/ | Удобный ответ: category и xfields часто уже с parsed |
GET /table/post/ | Универсальный CRUD-список той же таблицы |
Фильтры в обоих случаях — query-параметры (имена колонок).
Примеры
Опубликованные, 20 штук, свежие сверху:
curl -sS 'https://ВАШ_САЙТ/api/v2/post/?approve=1&limit=20&orderby=date&sort=DESC' \
-H 'Authorization: Bearer <access_token>'Категория + доп. поле:
GET /api/v2/table/post/?category=1&xf[linked_data]=значение
Authorization: Bearer <access_token>| Параметр | Смысл |
|---|---|
approve, category, … | Равно значению колонки |
limit / offset | Пагинация |
orderby / sort | Сортировка (ASC / DESC) |
xf[имя]=значение | Фильтр по доп. полю внутри xfields |
значение с % | LIKE (поиск «содержит») |
значение с ! | «не равно» |
На GET /post/ для совместимости со старыми клиентами часть фильтров ещё принимают через HTTP-заголовки с именами колонок — лучше сразу query.
Ответ списка обычно: { "data": [ … ], "count": N }.
Доп. поля подробно: xfields-news. Обзор фильтров в reference: HTTP.
Одна новость
GET /api/v2/post/42
Authorization: Bearer <access_token>Через SDK
DcApi::query('post')->where('approve', 1)->fetchAll() — SDK.