Общие сведения

DataSync HTTP API предназначен для синхронизации данных приложений на различных устройствах и платформах. С помощью API можно синхронизировать, например, пользовательские настройки, открытые вкладки, текущий статус игры и другие данные.

Синхронизация данных осуществляется через промежуточное хранилище (в дальнейшем хранилище синхронизации). Хранилище синхронизации размещается на серверах Яндекса. Оно используется для хранения текущего состояния данных приложения, а также истории всех изменений. Задача разработчика заключается в том, чтобы реализовать синхронизацию локальных данных приложения (данных, которые хранятся, например, в памяти приложения) с данными из хранилища синхронизации.

Обращение к хранилищу синхронизации осуществляется посредством HTTP-запросов. С помощью HTTP-методов клиентское приложение может загрузить из хранилища текущие данные, а также сохранить в нем изменения локальных данных.

Принцип работы с API подобен принципу работы с системами контроля версий. Перед тем как вносить изменения в локальные данные, необходимо получить их текущее состояние из хранилища синхронизации. Если приложение пытается сохранить в хранилище изменения, не обновив перед этим локальные данные, может возникнуть конфликтная ситуация. Логику разрешения конфликтов разработчику необходимо продумать самостоятельно.

Для доступа к хранилищу требуется OAuth-авторизация.

API поддерживает два формата обмена данными: JSON и Protocol Buffer.

Примечание. Взаимодействие с хранилищем производится по протоколу HTTPS.