Skip to content
HALOWERK

Bildwerk

qr generate

Encodes text (or base64 bytes) with node-qrcode following ISO/IEC 18004: automatic segment modes (numeric, alphanumeric, byte, kanji), smallest version for the chosen error-correction level unless a version is fixed. Returns SVG (one path, crisp edges) and/or PNG, version, size in modules, mask, segment modes and capacity facts. An optional centred logo area is cleared (levels Q/H only) and its share of the symbol is reported. Every PNG is decoded again with ZXing-C++ in a child process; the.

POST https://bild.halowerk.com/v1/qr-generate

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
datastringYesText to encode (UTF-8 in byte mode when needed).
data_is_base64booleanNoTreat data as base64 bytes and encode them unchanged in byte mode.
error_correctionstringNoError-correction level: L≈7 %, M≈15 %, Q≈25 %, H≈30 % recoverable codewords.
versionintegerNoFixed QR version (default: smallest that fits).
outputstringNo
module_pxintegerNoPNG pixels per module.
marginintegerNoQuiet zone in modules (ISO/IEC 18004 requires 4).
dark_colorstringNo
light_colorstringNo
logo_areanumberNoSide length of a centred blank square for a logo, as fraction of the symbol width (needs Q or H).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "data"
  ],
  "properties": {
    "data": {
      "type": "string",
      "minLength": 1,
      "maxLength": 7089,
      "description": "Text to encode (UTF-8 in byte mode when needed)."
    },
    "data_is_base64": {
      "type": "boolean",
      "default": false,
      "description": "Treat data as base64 bytes and encode them unchanged in byte mode."
    },
    "error_correction": {
      "type": "string",
      "enum": [
        "L",
        "M",
        "Q",
        "H"
      ],
      "default": "M",
      "description": "Error-correction level: L≈7 %, M≈15 %, Q≈25 %, H≈30 % recoverable codewords."
    },
    "version": {
      "type": "integer",
      "minimum": 1,
      "maximum": 40,
      "description": "Fixed QR version (default: smallest that fits)."
    },
    "output": {
      "type": "string",
      "enum": [
        "svg",
        "png",
        "both"
      ],
      "default": "both"
    },
    "module_px": {
      "type": "integer",
      "minimum": 1,
      "maximum": 40,
      "default": 8,
      "description": "PNG pixels per module."
    },
    "margin": {
      "type": "integer",
      "minimum": 0,
      "maximum": 16,
      "default": 4,
      "description": "Quiet zone in modules (ISO/IEC 18004 requires 4)."
    },
    "dark_color": {
      "type": "string",
      "pattern": "^#[0-9A-Fa-f]{6}$",
      "default": "#000000"
    },
    "light_color": {
      "type": "string",
      "pattern": "^#[0-9A-Fa-f]{6}$",
      "default": "#FFFFFF"
    },
    "logo_area": {
      "type": "number",
      "minimum": 0,
      "maximum": 0.3,
      "default": 0,
      "description": "Side length of a centred blank square for a logo, as fraction of the symbol width (needs Q or H)."
    }
  }
}

Open original schema

Published input example

{
  "data": "https://halowerk.com",
  "error_correction": "Q",
  "output": "svg"
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →