Оформление

​

Пример объекта дизайна

{
  "styles": {
    "dotsOptions": { "type": "rounded", "color": "#000000" },
    "backgroundOptions": { "color": "#ffffff" },
    "cornersSquareOptions": { "type": "dot", "color": "#000000" },
    "cornersDotOptions": { "type": "dot", "color": "#000000" }
  },
  "frameOptions": { "id": "card", "text": "Scan me!", "color": "#000000", "textColor": "#ffffff" },
  "logoOptions": { "type": "suggested", "id": "logo-google", "scalePercent": 25 }
}

curl -X POST "https://getqr.com/api/v1/qrs" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "qrType": "website",
    "data": "https://example.com",
    "styles": { "dotsOptions": { "type": "rounded", "color": "#1E40AF" } },
    "frameOptions": { "id": "card", "text": "Scan me!" },
    "logoOptions": { "type": "suggested", "id": "logo-website-3" }
  }'

​

Стили

• Цвета. Только шестнадцатеричные значения: #RGB или #RRGGBB.
• Коррекция ошибок. Всегда Q, и это не входной параметр. Передача styles.qrOptions возвращает 422.
• Branded и AI designs. Через API их задать нельзя. Передача styles.logoQrArt возвращает 422.
• Содержимое. styles.data игнорируется. Изображение всегда кодирует содержимое QR-кода.

​

Рамки

​

Логотипы

​

Готовый логотип

{ "logoOptions": { "type": "suggested", "id": "logo-instagram", "scalePercent": 25 } }

​

Собственный логотип

{ "logoOptions": { "type": "uploaded", "fileId": "file_7bQ2xR9mKp", "scalePercent": 35 } }

​

Размер логотипа

​

Обновление дизайна

• Частичное обновление. При Обновлении QR-кода объекты styles, frameOptions и logoOptions объединяются с сохранённым дизайном. Частичный объект меняет только то, что в нём указано.
• Смена логотипа. Выбор другого логотипа заменяет сохранённый, но сохраняет его scalePercent.
• Шаблоны. При создании с templateId переданные поля накладываются поверх дизайна шаблона. См. Шаблоны.
• Branded и AI designs. QR-код с designKind branded или ai создан в панели управления. API не может изменить его изображение, но сохраняет его, когда вы меняете другие поля.
• Чтение дизайна. Ответы возвращают сохранённый дизайн в design в той же структуре, что и поля запроса, поэтому его можно отправить обратно.

​

Частые проблемы

​

Что дальше