v1.0.0 release candidate

QR codes,
built for service.

A secure, stateless Go API that turns structured data into production-ready PNG QR codes—directly in the response.

10QR formats
1API response
0Stored data
QR generated
PNG · 256 px
QR code encoding https://qr-code-api_server-github.bigvault.cloud
data:image/png;base64,… ✓
ProtectedAPI key
DocumentedOpenAPI 3.1
Built for
GOGo 1.24
PNGDirect response
RESTVersioned v1
OCIDocker image
K8SKubernetes
10 QR formats

One API.
Every payload.

Purpose-built QR payloads for the information your application already carries.

01
↗

URL

Encode absolute HTTP and HTTPS destinations.

/qr/url
02
◎

vCard

Share contact details, titles, and websites.

/qr/vcard
03
⌁

Wi-Fi

Configure WPA, WEP, or open networks.

/qr/wifi
04
□

Calendar

Create timed or all-day iCalendar events.

/qr/calendar
05
T

Text

Carry plain text without an intermediary service.

/qr/text
06
⇩

File

Embed small files as validated data URIs.

/qr/file
07
#

Number

Encode numbers and telephone-style values.

/qr/number
08
@

Email

Pre-fill recipients, subjects, and message bodies.

/qr/email
09
◫

SMS

Open a prepared text message with a destination.

/qr/sms
10
⌖

Geolocation

Share coordinates and a human-readable label.

/qr/geolocation
Designed for delivery

Small footprint.
Serious control.

From a single container to a Kubernetes fleet, every layer is stateless, observable, and predictable.

01
API-key protection

Authenticate with a header or Bearer token.

02
Embedded logos

Upload a PNG or use the server fallback.

03
Strict validation

Reject malformed payloads and unknown fields.

04
Observable probes

Expose liveness and readiness endpoints.

qr-service / status live
POST/api/v1/qr/url200
POST/api/v1/qr/vcard200
POST/api/v1/qr/wifi200
GET/healthz200
{   "format": "png",   "size": 256,   "logo_source": "fallback" }
Developer experience

From payload
to response.

Make a request, receive a rendered PNG—without a second fetch or persistent storage.

$ curl --request POST http://localhost:8080/api/v1/qr/url \
  --header 'X-API-Key: your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{"url":"https://example.com","show_logo":true}'
Ship anywhere

Container ready.
Kubernetes native.

Deploy with the included Dockerfile and Kubernetes manifests, or use the signed GHCR image publication workflow.

Deployment guide
D
DockerMulti-stage · non-root
ready
K8
KubernetesProbes · resources · secrets
ready
GH
GitHub Container RegistryLatest · release tag · signed
ready
Open source · Go

Give every payload
a useful QR code.