Concepts

Deep dives into the core ideas behind the API. Read these once and you understand every parameter you will ever pass.

• Static vs dynamic QRs

Why dynamic exists, when to print which, and what changes once a QR is in the world.

• Data types

What goes in data vs payload. URL, vCard, Wi-Fi, email, SMS, geo, and dynamic.

• Styling and colors

Modules, finders, gradients, eye styles, frames, transparent backgrounds.

• Logos

Uploading, sizing, the clear-zone behind your logo, neon alpha stripping.

• Bulk generation

The all-or-nothing batch endpoint that returns a ZIP plus a manifest.

• Caching

The 24 hour content-addressed render cache, what is in the key, and how to bust it.

• PNG vs SVG

File-size, scalability, and tooling trade-offs.

• Security model

Key hashing, SSRF protection, webhook signing, dynamic redirect cache headers.

• Reliability and SLA

Health and status endpoints, regional failover, idempotency.