Skip to content

Latest commit

 

History

History
82 lines (65 loc) · 2.73 KB

diff.md

File metadata and controls

82 lines (65 loc) · 2.73 KB

Запрос разницы

GET <context-url>/since/<revision-uuid>
Код Тело Описание
200 Cubux.Sync.Response Данные в поле data были готовы заранее
202 Cubux.Sync.Response Обработка поставлена в очередь. В поле ticket указан тикет для отслеживания результата.
204 Изменений после указанной ревизии нет
304 В кеше клиента содержатся актуальные данные, если клиент использует HTTP кеширование.
410 Базовая ревизия <revision-uuid> слишком старая. Необходимо запросить снапшот.

Прочие коды ответов 4xx и 5xx должны обрабатываться согласно спецификации HTTP

Пример

Запрос:

GET /api/v2/sync/user/since/372cf009-992e-471d-ab13-59ac428e062e HTTP/1.1
Host: app.cubux.net
Authorization: Bearer bd21026244e41a126d69f15ea9d1ac76579f69e3

Ответ, данные уже были готовы ранее:

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
...

{
    "ticket": null,
    "data": {
        "base_revision": "372cf009-992e-471d-ab13-59ac428e062e",
        "revision":      "a733351e-50c3-4c87-9af6-6a7ab48d49f8",
        "serial":        294,
        "created_at":    "2017-10-19T06:21:47Z",
        "deleted_objects": {
            "me": null,
            "messages": [],
            "teams": []
        },
        "objects": {
            "me": {
                "uuid": "0fdafba5-b3e6-47d8-bd12-c2b23957598e",
                "notify_language": null,
                "username": "Пупкин Василий"
            },
            messages: [],
            teams: []
        }
    }
}

Ответ, обработка поставлена в очередь:

HTTP/1.1 202 Accepted
Content-Type: application/json; charset=UTF-8
...

{
    "ticket": {
        "uuid":       "bc7a1c11-e972-4268-bb85-b348b1745d5a",
        "client_serial":     null,
        "status":            "new",
        "created_at":        "2017-10-19T05:30:58Z",
        "status_changed_at": "2017-10-19T05:30:58Z",
        "errors":            []
    },
    "data": null
}

Ответ, изменений нет:

HTTP/1.1 204 No Content