DevCraft Документации
Гайды

Поиск новостей v200.1.0

Как получить список новостей с фильтрами: GET /post/ и GET /table/post/.

Нужно найти опубликованные новости из категории или с определённым доп. полем — этот гайд. Создание — posts-create.

Что нужно заранее

Два 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.

См. также

На этой странице