← Повернутися до особової справи
ДОДАТОК № 03 QA PERSONNEL FILE / KR–01 СТАТУС: ВІДКРИТО

API та
дані

Коли інтерфейс показує лише симптом, я дивлюся глибше: на запит, відповідь і стан даних.

Формат корпусуREST / JSON
Я перевіряюКонтракт / коди статусу / конфлікти
ФокусЦілісність даних і межі
01 / API

Що повернув сервіс

Я перевіряю тіла запитів, коди відповідей, структуру JSON і поведінку з дійсними та недійсними даними.

02 / ДАНІ

Що можна синхронізувати

Я перевіряю, які поля є переносними, а які мають залишитися на пристрої.

ФАКТИЧНИЙ КОНТРАКТ · MOTI

Синхронізація стану з контролем версій

PARTIAL · LIVE RETEST NEEDED
Ресурс/state
методиGET / PUT
Захист від конфліктівexpectedRevision
ПРОЧИТАЙТЕ
GET /state
200 OK
{
  "revision": 7,
  "state": { ... }
}
ОНОВЛЕННЯ
PUT /state
Content-Type: application/json
{
  "expectedRevision": 7,
  "state": { ... }
}
ПеревіртеОчікуванийпризначення
Поточна редакція200

Стан зберігається, а перегляд збільшується на одиницю.

Застаріла версія409

Сервер повертає поточний стан, не перезаписуючи чужі зміни.

Відсутня очікувана версія422

Оновлення відхиляється до запису будь-яких даних.

Недійсний JSON400

Служба повертає явну помилку invalid_json.

Невідомий шлях404

Відповідь не маскується під успішний статус.

ПОРТАТИВНІ ДАНІ

Статистика Моті, пам’ять, особистість, факти власника, довіра та версія схеми.

ЗАЛИШАЄТЬСЯ НА ПРИСТРОЇ

Ключі та маркери, ключ творця, геометрія вікна, дозволи на доступність і локальне середовище ШІ.

ПЕРЕВІРЕНО

Спрацювала базова синхронізація чотирьох полів; перегляд і обробка коду відповіді реалізовані на клієнті та сервері.

НЕ ПЕРЕВІРЕНО

Розширена відповідь із пам’яттю, особистістю, ownerFacts і довірою вимагає ще одного живого GET /state після запуску поточного сервера.