Импорт оправ — формат файла

«Импорт оправ» — это инструмент восстановления для обращений в поддержку: например, чтобы вернуть коллекцию оправ после потери устройства, когда резервной копии iCloud нет. По умолчанию он скрыт: пункт появляется в Настройках → Резервная копия только после того, как поддержка Frame включит его для вашего аккаунта. Если вам кажется, что он нужен, сначала напишите нам на [email protected].

Структура папки

Импортер просит выбрать папку, в которой лежат один файл-манифест и фотографии, на которые он ссылается:

My Frames/
├── frames.json
├── rayban-aviator.jpg
├── rayban-aviator-sticker.jpg
└── persol-649.jpg

Фотографии могут лежать и в одной вложенной подпапке — импортер находит имена файлов на один уровень вглубь.

frames.json

{
  "version": 1,
  "frames": [
    {
      "client_id": "5D2A7C1E-4B9F-4E2A-8C3D-1F6E9A0B2C4D",
      "name": "Ray-Ban Aviator",
      "image": "rayban-aviator.jpg",
      "sticker_image": "rayban-aviator-sticker.jpg",
      "brand": "Ray-Ban",
      "model": "RB3025",
      "shape": "aviator",
      "is_favorite": true,
      "price_amount": 161.0,
      "price_currency": "USD",
      "product_url": "https://example.com/rb3025",
      "created_at": "2026-05-01T10:00:00Z"
    },
    {
      "client_id": "0A1B2C3D-4E5F-6789-ABCD-EF0123456789",
      "name": "Persol 649",
      "image": "persol-649.jpg"
    }
  ]
}

Поля

ПолеОбязательноПримечания
client_idдаСтрока UUID. Дубликаты оправ, уже имеющихся на устройстве, пропускаются и никогда не перезаписываются.
nameдаОтображаемое название оправы.
imageжелательноОтносительный путь к главному фото товара (JPEG/PNG). Отсутствие файла допустимо — оправа импортируется без фото.
sticker_image, additional_image_1, additional_image_2нетДополнительные фото, правила путей те же, что у image.
brand, model, shape, size, material, color_variantнетПроизвольные строки.
lens_width, bridge_width, temple_lengthнетМиллиметры, числа.
is_favoriteнетБулево значение, по умолчанию false.
price_amount, price_currency, original_price_amount, product_urlнетМетаданные о цене.
created_atнетМетка времени ISO 8601; по умолчанию — время импорта.
Голый JSON-массив записей об оправах (без обёртки {"version", "frames"}) тоже принимается — как устаревший вариант.

Как ведёт себя импорт