TEASEDocs
API ReferenceLandings

Render a QR design preview

Renders an arbitrary design as an SVG string for a live constructor preview — the same deterministic engine that serves the saved codes; nothing is stored. Requires a write-scoped key.

Authorization

bearerAuth
AuthorizationBearer <token>

Your al_live_<prefix>_<secret> API key. Mint and manage keys in the dashboard.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

POST
/api/admin/qr/render
curl -X POST "https://example.com/api/admin/qr/render" \  -H "Content-Type: application/json" \  -d '{    "design": {      "module": "rounded",      "eye_frame": "rounded",      "eye_dot": "rounded",      "fg": "#101014",      "bg": "#ffffff",      "card_radius": 28    },    "url": "https://links.creator.com/qr/flyer"  }'
{  "svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 490 490\" width=\"512\" role=\"img\" aria-label=\"QR\">…</svg>"}
{  "detail": {    "code": "design_invalid",    "message": "module: один из square, rounded, dot, diamond"  }}
{  "detail": "auth required"}

List icons usable as a QR centre logo

Returns the icon names (the button icon set) that a design's logo field can reference as 'icon:<name>'. Requires a read-scoped key.

List a domain's QR codes

Returns every QR code of the domain (in creation order) together with its live funnel stats — scans, labelled visits, human button clicks, and the subscriptions/revenue attributed to those clicks. Requires a read-scoped key.