Dezvoltatori — API · MCP · CLI

Creează un WIA Code într-o singură linie. Nu ai nevoie de cheie în limitele gratuite.

Building an AI or vision system? WIA Code identification reference for AI systems — the three centre elements, why the outline is free, and the misidentifications to avoid. Plain-text counterpart: /llms.txt.

CLI — o singură linie, fără instalare

npx wiacode "https://wiacode.com" --shape heart

Rulează imediat pe Node 18 sau mai nou, fără instalare. Nu are dependențe, deci descărcarea durează câteva secunde.

npx wiacode --list-shapes              # silhouettes and capacity
npx wiacode "Hello" --shape square -o hello.png
npx wiacode "a link" --shape heart --json    # print metadata only
npx wiacode card --name "Jane Doe" --tel "+82-10-1234-5678"   # wifi / card / event

Tipuri — Wi-Fi, card de contact, eveniment

Trei tipuri gata pregătite. Nu trebuie să asamblați dumneavoastră șirurile — trimiteți câmpurile, iar serverul construiește conținutul standard Wi-Fi/vCard/iCalendar, identic octet cu octet cu ceea ce produce generatorul de pe acest site.

CLI

npx wiacode wifi  --ssid "MyNet" --password "secret"
npx wiacode wifi  --ssid "Cafe" --security nopass          # open network
npx wiacode card  --name "Jane Doe" --org "SmileStory" --tel "+82-10-1234-5678" --email "a@b.c"
npx wiacode event --title "Launch party" --start "2026-09-01 19:00" --end "2026-09-01 21:00" --location "Seoul"

REST

curl -X POST https://wiacode.com/api/v1/code \
  -H 'Content-Type: application/json' \
  -d '{"type":"card","name":"Jane Doe","tel":"+82-10-1234-5678","shape":"square"}' \
  -o card.png

Câmpuri

Orele sunt scrise "2026-09-01 19:00". Pentru o rețea Wi-Fi deschisă, trimiteți security=nopass și omiteți parola. Câmpurile lipsă sau incorect formatate sunt returnate ca HTTP 400 cu un mesaj care indică numele câmpului — nu se generează nicio imagine, deci o cerere incorectă nu ocupă niciodată un loc de randare.

Mai multe deodată

O linie pentru fiecare cod. La atingerea limitei de rată, așteaptă și continuă în loc să se oprească la jumătate, iar liniile eșuate sunt raportate cu numărul lor real de linie.

npx wiacode batch people.jsonl --out-dir codes

# people.jsonl
{"type":"card","name":"Jane Doe","tel":"+82-10-1234-5678","out":"jane.png"}
{"type":"wifi","ssid":"Cafe WIA","security":"nopass"}
{"text":"https://wiacode.com","shape":"star"}

REST API

POST /api/v1/code

curl -X POST https://wiacode.com/api/v1/code \
  -H 'Content-Type: application/json' \
  -d '{"text":"https://wiacode.com","shape":"heart"}' \
  -o wiacode.png

Răspunsul este image/png. Adaugă ?format=json pentru a primi base64 și metadate ca JSON.

curl -X POST 'https://wiacode.com/api/v1/code?format=json' \
  -H 'Content-Type: application/json' \
  -d '{"text":"https://wiacode.com","shape":"square"}'

Apelarea din browser

O poți apela direct dintr-o aplicație web de pe orice origine. Este un API public care nu folosește cookie-uri, astfel încât CORS este deschis.

const r = await fetch('https://wiacode.com/api/v1/code?format=json', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ text: 'https://wiacode.com', shape: 'heart' })
});
const { image, meta } = await r.json();
document.querySelector('img').src = image;   // data:image/png;base64,...

GET /api/v1/shapes

curl https://wiacode.com/api/v1/shapes

Parametri

Siluete și capacitate

Fiecare siluetă are o capacitate diferită (bytes UTF-8). Folosește square pentru conținut lung; orice siluetă merge pentru linkuri scurte.

MCP — lasă AI-ul să-l creeze

Conectează-l la un client AI precum Claude și codurile se creează direct în conversație. Endpoint-ul este https://mcp.wiacode.com/mcp și nu necesită cheie.

Configurare Claude Desktop

{
  "mcpServers": {
    "wiacode": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.wiacode.com/mcp"]
    }
  }
}

Dacă clientul tău suportă direct Streamable HTTP, e suficient să introduci acest URL.

Instrumente

Limite gratuite

• 10 cereri pe minut per IP. Atât poți folosi imediat, fără cheie.
• Un cod durează până la aproximativ 4 secunde — serverul verifică dacă respectivul cod poate fi citit efectiv înainte de a-l trimite înapoi.
• Când cererile se aglomerează, serverul așteaptă puțin și apoi răspunde cu 503. E suficient să încerci din nou peste puțin timp.
• Peste limită primești 429 împreună cu numărul de secunde de așteptat.

WIA Stream — when one code isn't enough

A single WIA Code holds up to 1,450 bytes. When the payload is larger — a document, a book chapter, an audio clip — Stream splits it across many frames. A screen plays them in sequence, a camera collects them, and the scanner reassembles the file. No internet, no server. It already ships in the generator.

What matters here is not speed — it is whether the transfer finishes at all. Stream needs every frame. A frame that fails to read must wait for the next pass, and may fail again. So a per-frame reading gap does not average out; it multiplies into the completion time. In our degradation sweep at matched physical size (1064 vs 1088 px, n=17, QR read with ZBar), a high-version QR frame read 52.9% of the time while a WIA frame read 17 of 17. Feeding those rates into a cyclic-broadcast model, a 286-frame QR transfer needs about 8 passes to complete while a 155-frame WIA transfer needs about one.

Read this honestly: n = 17 is a small sample. By the rule of three, "17 of 17" should be read as ≥ 82% with 95% confidence, and the 52.9% figure carries a 29–77% interval. Taking the least favourable end of both, the completion-time gap is still about 2.4×. Screen-to-camera capture on real handsets and printed output have not been measured yet. And QR wins on blur resistance at equal frame size — we only pull ahead once capacity is matched.

Mai multe

• Ce este un WIA Code? — pentru cei (și AI-urile) care întreabă ce e acest cod
• Generator — creează unul direct în browser
• Scaner — citește unul fără să instalezi nimic
• Producători · Angajament deschis pentru OEM — treci testul de conformitate și oricine îl poate integra, fără redevențe
• Integrarea WIA Code într-un scaner existent — pentru echipele POS, chioșc și SDK de scaner

WIA Code este un produs SmileStory Co., Ltd. Booster QR este un ghid care ajută și persoanele fără scaner dedicat să îl citească.