boards

Сохранить дельту (операции над узлами) вместо документа целиком

Права — те же, что у /save. Только для документов модели v2 (дерево). Операции применяются к текущему документу под замком доски, итог проходит тот же разбор, что и полный /save (белые списки полей, целостность дерева, квоты) — отказ любой операции откатывает весь патч. baseRev обязателен: при несовпадении — 409 с текущим doc в ответе (объедините правки, пересчитайте патч от него и повторите с новым baseRev). opId — идемпотентность: повтор с тем же opId отвечает ok с текущим rev и ничего не применяет (сервер помнит последние 50 на доску). Лимиты: общая корзина с /save (600/ч на IP), ≤ 2000 операций, тело ≤ 1 МиБ. Тело принимается и как text/plain (так шлёт navigator.sendBeacon).

post/save/patch

Request

  • Base URL: https://maketa.pro/maketa/api
  • URL: https://maketa.pro/maketa/api/save/patch
  • Auth: one of:
    • none
    • API key in header x-maketa-key

Request body

idstring required
editstring

edit-токен (не нужен при x-maketa-key своей доски или linkAccess=edit)

baseRevinteger required

Ревизия, к которой относится патч (rev из последнего /load, /save, /save/patch или /rev). Обязателен.

opIdstring

Идемпотентность повтора: уникален для каждого патча

Response

Применено (или уже было применено — repeated: true)

okboolean
revinteger
updatedAtinteger
repeatedboolean

Повтор opId — патч не применялся второй раз

Changes

No recorded changes to this operation across all 1 revision of this API.