API v1

Записи: чтение

Список записей коллекции, одна запись или запрос с фильтром. Все методы чтения требуют records:read.

Список записей коллекции, одна запись или запрос с фильтром. Все методы чтения требуют records:read.

#Список записей

http

GET /api/v1/collections/{collection}/records?limit=50&cursor=0
Authorization: Bearer ВАШ_ТОКЕН

#Одна запись

http

GET /api/v1/records/{record}
Authorization: Bearer ВАШ_ТОКЕН

#Формат записи

json

{
  "id": "9e…record-uuid",
  "collectionId": "9e…collection-uuid",
  "title": "Поставка на 250 000 ₽",
  "stageId": "9e…stage-uuid",
  "values": { "9e…field-uuid": "Ромашка" },
  "createdAt": "2026-09-13T10:00:00+00:00",
  "updatedAt": "2026-09-13T11:00:00+00:00"
}

#Запрос с фильтром и сортировкой

bash

curl -X POST https://ВАШ_ДОМЕН/api/v1/collections/{collection}/records/query \
  -H "Authorization: Bearer ВАШ_ТОКЕН" \
  -H "Content-Type: application/json" \
  --data '{
    "filter": { "conj": "and", "rules": [
      { "fieldId": "9e…field-uuid", "op": "contains", "value": "Acme" }
    ]},
    "sort": { "fieldId": "__stage", "dir": "asc" },
    "limit": 50,
    "cursor": 0
  }'

#Ответ query

json

{
  "data": [ { "id": "…", "collectionId": "…", "title": "…", "values": {} } ],
  "total": 137,
  "nextCursor": 50
}

limit — 1…200, по умолчанию 50.
cursor — смещение (offset); nextCursor: null значит конец списка.

Поиска пока нет

Свободного поиска по ключевым словам в публичном API v1 нет. Выборку делайте фильтрами — в том числе contains по текстовым полям.

Форма фильтра — такая же, как строит конструктор фильтров в приложении. Все операторы — в статье «Фильтры и сортировка».