Данные фрагментов RAG для DataTables

GET

/wp-json/wp2tutor/rag/v1/datatables

curl --request GET \
  --url 'https://example.com/wp-json/wp2tutor/rag/v1/datatables?draw=1&start=0&length=25&search%5Bvalue%5D=%D1%8D%D0%BC%D0%B1%D0%B5%D0%B4%D0%B4%D0%B8%D0%BD%D0%B3&order%5B0%5D%5Bcolumn%5D=6&order%5B0%5D%5Bdir%5D=desc' \
  --header 'X-WP-Nonce: <X-WP-Nonce>'

Серверная выдача SQLite-фрагментов текущего блога в формате DataTables. PHP ChunksDataTablesController::datatables: array_merge(get_query_params(), get_body_params()) — JSON-тело не читается. Админка (chunks_datatable.js) шлёт GET с X-WP-Nonce, pageLength 25, сортировка [[6, desc]] (колонка created_at). Поиск LIKE по content, id_post, id_chunk, content_hash, metadata. Нет PDO — recordsTotal/recordsFiltered 0, data []. Нужно manage_options. Не рантайм чата.

Authorizations

• cookie
• applicationPassword

Parameters

Query Parameters

draw

integer

default: 1 >= 1

Счётчик DataTables. PHP (int), затем max(1, …); по умолчанию 1. Эхо в ответе draw.

Example

1

start

integer

0

OFFSET выборки. PHP max(0, (int)), по умолчанию 0.

Example

0

length

integer

default: 25 >= 1 <= 100

LIMIT. PHP min(100, max(1, (int))), по умолчанию 25. Админка lengthMenu 25/50/75/100.

Example

25

search[value]

string

Строка поиска DataTables. PHP: $params['search']['value'], sanitize_text_field. LIKE %term% по content, id_post, id_chunk, content_hash, metadata. Пусто — без фильтра.

Example

эмбеддинг

order[0][column]

integer

default: 3

Индекс колонки DataTables (order[0][column]). PHP (int), по умолчанию 3. ChunkReadModel: 1 → status, 2 → id_chunk, 5 → id_post, 6 → created_at; иное (в т.ч. 3 — превью, 4 — metadata) → created_at. Админка по умолчанию колонка 6.

Example

6

order[0][dir]

string

default: desc

Allowed values: asc desc ASC DESC

Направление (order[0][dir]). PHP sanitize_key, затем ASC только если строка ASC (без учёта регистра), иначе DESC. По умолчанию desc.

Example

desc

Responses

200

DataTables { draw, recordsTotal, recordsFiltered, data }. draw — эхо (min 1). recordsTotal — COUNT по id_site. recordsFiltered — COUNT после search.

Media typeapplication/json

object

draw

Эхо входного draw после max(1, …).

integer

recordsTotal

COUNT(*) чанков текущего id_site без поиска. Нет PDO — 0.

integer

recordsFiltered

COUNT(*) после LIKE-поиска (или равно recordsTotal, если search пуст). Нет PDO — 0.

integer

data

Строки страницы (LIMIT/OFFSET). Не payload WP_Error/лицензии.

Array<object>

object

select

PHP всегда ''. Чекбокс рисует клиент DataTables, не REST.

string

status

ChunkStatus строки SQLite (0 PENDING, 1 ACTIVE, 2 INDEXING, −1 ERROR).

integer

status_icon

Эмодзи PHP match: 1 → 🟢, 2 → 🔵, −1 → 🔴, иначе ⚪ (в т.ч. PENDING 0).

string

id_chunk

ID фрагмента.

integer

content_preview

Первое предложение content (до .?! + пробел) или первые 200 символов; HTML снят, пробелы схлопнуты.

string

metadata_html

HTML из JSON metadata (source.post_type/anchor, taxonomies). Невалидный JSON — ''.

string

source_post

object

id

Id_post чанка (запись WordPress, из которой нарезан фрагмент).

integer

title

Get_the_title(id_post); нет заголовка — ''.

string

edit

Get_edit_post_link(id_post, raw); если не строка — ''.

string

created_at

UTC mysql datetime из SQLite (как current_time(‘mysql’, true)).

string

created_at_human

Локальное wp_date('d.m.Y H:i') после get_date_from_gmt.

string

Example

{
  "draw": 1,
  "recordsTotal": 120,
  "recordsFiltered": 8,
  "data": [
    {
      "select": "",
      "status": 1,
      "status_icon": "🟢",
      "id_chunk": 42,
      "content_preview": "Эмбеддинг — векторное представление текста.",
      "metadata_html": "<div class=\"wp2tutor-rag-meta\"><h4>Source</h4><ul><li><strong>post_type:</strong> page</li></ul></div>",
      "source_post": {
        "id": 15,
        "title": "Введение в RAG",
        "edit": "https://example.com/wp-admin/post.php?post=15&action=edit"
      },
      "created_at": "2026-09-13 10:00:00",
      "created_at_human": "13.09.2026 13:00"
    }
  ]
}

401

Не аутентифицирован. DualRest: rest_forbidden (status 401), если нет cookie-сессии. Cookie + X-WP-Nonce или Application Password.

Media typeapplication/json

object

code

Код WP_Error. Для POST /chat 401 — rest_forbidden. DualRest cookie — rest_forbidden / rest_not_logged_in / rest_cookie_invalid_nonce.

string

message

Сообщение WP_Error (для секрета чата — Missing or invalid secret.).

string

data

Обычно { status: HTTP-код }, как PHP кладёт в WP_Error data.

object

Example

{
  "code": "rest_forbidden",
  "message": "Missing or invalid secret.",
  "data": {
    "status": 401
  }
}

403

Нет права manage_options или невалидный REST nonce. WordPress REST: rest_forbidden / rest_cookie_invalid_nonce.

Media typeapplication/json

object

code

Код WP_Error. Для POST /chat 401 — rest_forbidden. DualRest cookie — rest_forbidden / rest_not_logged_in / rest_cookie_invalid_nonce.

string

message

Сообщение WP_Error (для секрета чата — Missing or invalid secret.).

string

data

Обычно { status: HTTP-код }, как PHP кладёт в WP_Error data.

object

Example

{
  "code": "rest_forbidden",
  "message": "Missing or invalid secret.",
  "data": {
    "status": 401
  }
}