안경테 가져오기 — 파일 형식

안경테 가져오기는 고객지원용 복구 도구예요 — 예를 들어 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"} 래퍼 없이)도 레거시 형식으로 지원돼요.

가져오기 동작 방식