Bato ya kosala mangbanga — API · MCP · CLI

Sala WIA Code na molongo moko. Ozali na mposa ya fungola te na kati ya ndelo ya ofele.

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 — molongo moko, kotia te

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

Ekimaka mbala moko na Node 18 to oyo ya sika koleka, kozanga kotia. Ezali na ba dépendance te, yango wana kozwa yango esengeli kaka na basegonde moke.

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

Ndenge — Wi-Fi, karte ya boyokani, likambo

Ndenge misato oyo esilaki kobongisama. Osengeli te kosangisa ba string yango yo moko — pesá bisika (fields), mpe severi ekosala content ya Wi-Fi / vCard / iCalendar ya standard, ekokani na oyo générateur ya site oyo esalaka, byte na byte.

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

Bisika (Fields)

Ngonga ekomamaka lokola "2026-09-01 19:00". Mpo na réseau Wi-Fi ya polele (open), pesá security=nopass mpe tiká password. Bisika oyo ezangi to ezali na formatage mabe ezongaka lokola HTTP 400 elongo na message oyo elobi nkombo ya esika yango — elilingi ekosalema te, yango wana requête ya mabe ezwaka esika ya render ata moke te.

Ebele na mbala moko

Molongo moko mpo na code moko. Soki ekomi na ndelo ya rate limit, ezelaka mpe ekobaka, na esika ya kotelema na katikati, mpe eyebisaka miline oyo elongaki te elongo na motango ya solo ya molongo na yango.

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

Eyano ezali image/png. Bakisa ?format=json mpo na kozwa base64 na metadata na lolenge ya JSON.

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

Kobenga yango uta na navigatɛrɛ

Okoki kobenga yango mbala moko uta na aplikasyɔ ya web ya origine nyonso. Ezali API ya bato nyonso oyo esalelaka cookies te, yango wana CORS efungwami.

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

Ba paramètres

Ba silhouettes na bokoki ya kobomba

Silhouette moko na moko ebombaka bokoki ya ndenge mosusu (ba octet UTF-8). Salela square mpo na makomi milai; lolenge nyonso ebongi mpo na ba lien mokuse.

MCP — tika AI esala yango

Kangisa yango na client AI lokola Claude, mpe esalaka ba code kati na lisolo. Endpoint ezali https://mcp.wiacode.com/mcp mpe fungola esengami te.

Kotia Claude Desktop

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

Soki client na yo ezali kondima Streamable HTTP na mbala moko, pesa yango kaka URL.

Bisaleli

Ndelo ya ofele

• Bosenga 10 na minuti moko na IP moko. Yango nde okoki kosalela mbala moko kozanga fungola.
• Code moko esengeli soki basegonde 4 — server etalaka soki code oyo esalemi ekoki mpenza kotangama liboso ya kozongisa yango.
• Ntango basenga ebakisami mingi, server ezelaka mwa moke mpe eyanolaka na 503. Benga lisusu mwa moke na sima.
• Soki oleki ndelo, okozwa 429 elongo na motango ya basegonde osengeli kozela.

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.

Mingi

• WIA Code nini? — mpo na bato (na AI) oyo batunaka nini code oyo ezali
• Générateur — sala moko na navigateur na yo
• Scanner — tanga moko kozanga kotia eloko
• Manufacturers · OEM — elaka ya bonsomi: leká na test ya conformité mpe moto nyonso akoki ko-intégrer yango, kozanga kofuta redevance
• Kokɔtisa WIA Code na sikanɛrɛ oyo esilaki kozala — mpo na ba ekipe ya POS, kiosque mpe SDK ya sikanɛrɛ

WIA Code ezali produit ya SmileStory Co., Ltd. Booster QR ezali motambwisi oyo esungaka bato oyo bazangi scanner ya sika mpo na kotanga yango mpe.