Personalização

​

Exemplo de objeto de design

{
  "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" }
  }'

​

Estilos

• Cores. Apenas valores hexadecimais: #RGB ou #RRGGBB.
• Correção de erros. Sempre Q, e não é um parâmetro de entrada. Enviar styles.qrOptions devolve 422.
• Branded designs e AI designs. Não podem ser definidos através da API. Enviar styles.logoQrArt devolve 422.
• Conteúdo. styles.data é ignorado. A imagem codifica sempre o conteúdo do código QR.

​

Molduras

​

Logótipos

​

Logótipo sugerido

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

​

O seu próprio logótipo

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

​

Tamanho do logótipo

​

Atualizar um design

• Atualizações parciais. Em Atualizar um código QR, styles, frameOptions e logoOptions são combinados com o design guardado. Um objeto parcial só altera o que indica.
• Mudar o logótipo. Escolher outro logótipo substitui o guardado, mas mantém o respetivo scalePercent.
• Modelos. Com templateId na criação, os campos que enviar são combinados sobre o design do modelo. Consulte Modelos.
• Branded designs e AI designs. Um código QR com designKind branded ou ai foi criado no painel. A API não pode editar a respetiva imagem, mas mantém-na quando altera outros campos.
• Ler um design. As respostas devolvem o design guardado em design, com a mesma estrutura dos campos do pedido, pelo que o pode reenviar.

​

Problemas comuns

​

Próximos passos