Utviklere — API · MCP · CLI

Lag en WIA Code med én linje. Innenfor den gratis grensen trenger du ingen nøkkel.

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 — én linje, ingen installasjon

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

Kjører umiddelbart på Node 18 eller nyere, uten installasjon. Den har ingen avhengigheter, så det tar bare noen sekunder å hente den.

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

Typer — Wi-Fi, kontaktkort, hendelse

Tre ferdige typer. Du trenger ikke sette sammen strengene selv — send inn feltene, så bygger serveren standard Wi-Fi-/vCard-/iCalendar-innhold, byte for byte identisk med det generatoren på dette nettstedet lager.

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

Felt

Tidspunkt skrives som "2026-09-01 19:00". For et åpent Wi-Fi-nettverk sender du inn security=nopass og utelater passordet. Manglende eller feil formaterte felt kommer tilbake som HTTP 400 med en melding som navngir feltet — det gjengis ikke noe bilde, så en ugyldig forespørsel opptar aldri en gjengivelsesplass.

Mange på én gang

Én linje per kode. Ved en hastighetsgrense venter den og fortsetter i stedet for å stoppe midtveis, og rapporterer mislykkede linjer med deres faktiske linjenummer.

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

Svaret er image/png. Legg til ?format=json for å få base64 og metadata som JSON.

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

Kalle den fra en nettleser

Du kan kalle den direkte fra en nettapp på et hvilket som helst opphav. Det er et offentlig API som ikke bruker informasjonskapsler, så CORS er åpent.

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

Parametere

Silhuetter og kapasitet

Hver silhuett rommer en ulik mengde (UTF-8-bytes). Bruk square for langt innhold; hvilken som helst form fungerer for korte lenker.

MCP — la AI-en lage den

Koble den til en AI-klient som Claude, så lages koder rett i samtalen. Endepunktet er https://mcp.wiacode.com/mcp og krever ingen nøkkel.

Oppsett for Claude Desktop

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

Hvis klienten din støtter Streamable HTTP direkte, er det bare å oppgi denne URL-en.

Verktøy

Gratis grenser

• 10 forespørsler per minutt per IP. Det kan du bruke med én gang uten nøkkel.
• Én kode tar opptil ca. 4 sekunder — serveren sjekker at koden den lagde faktisk kan leses, før den sendes tilbake.
• Når forespørsler hoper seg opp, venter serveren litt og svarer så med 503. Bare prøv igjen om en liten stund.
• Over grensen får du 429 sammen med hvor mange sekunder du må vente.

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.

Mer

• Hva er en WIA Code? — for folk (og AI-er) som lurer på hva denne koden er
• Generator — lag en rett i nettleseren
• Skanner — les en uten å installere noe
• Produsenter · Åpent OEM-løfte — bestå samsvarstesten, så kan hvem som helst integrere den, royalty-fritt
• Integrere WIA Code i en eksisterende skanner — for POS-, kiosk- og skanner-SDK-team

WIA Code er et produkt fra SmileStory Co., Ltd. Booster-QR-en er en guide som hjelper også folk uten den dedikerte skanneren med å lese den.