Luchd-leasachaidh — API · MCP · CLI

Dèan WIA Code ann an aon loidhne. Chan eil iuchair a dhìth taobh a-staigh nan crìochan an-asgaidh.

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 — aon loidhne, gun stàladh

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

Ruitheas e sa bhad air Node 18 no nas ùire, gun stàladh. Chan eil eisimeileachdan sam bith aige, mar sin cha toir faighinn a-steach ach beagan dhiogan.

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

Seòrsaichean — Wi-Fi, cairt fios-conaltraidh, tachartas

Trì seòrsaichean deiseil-dèanta. Chan fheum thu na sreathan a chur ri chèile thu fhèin — thoir seachad na raointean agus togaidh am frithealaiche susbaint àbhaisteach Wi-Fi / vCard / iCalendar, co-ionann, byte air byte, ris na tha an gineadair air an làrach seo a' dèanamh.

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

Raointean

Tha amannan ann an cruth "2026-09-01 19:00". Airson lìonra Wi-Fi fosgailte, thoir seachad security=nopass agus fàg am facal-faire às. Ma tha raon a dhìth no cearr, thig HTTP 400 air ais a dh'ainmicheas an raon — cha dèanar dealbh sam bith, agus mar sin chan eil iarrtas cearr a-riamh a' gabhail àite reandaraidh.

Mòran an-cois a chèile

Aon loidhne airson gach còd. Nuair a ruigear crìoch reata, feithidh e agus leanaidh e air adhart seach stad letheach slighe, agus innsidh e mu loidhnichean a dh'fhàillig leis na fìor àireamhan-loidhne aca.

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

'S e image/png a th' anns an fhreagairt. Cuir ?format=json ris gus base64 agus meata-dàta fhaighinn mar JSON.

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

Ga ghairm bhon bhrobhsair

'S urrainn dhut a ghairm gu dìreach bho aplacaid-lìn air tùs sam bith. Is API poblach a th' ann nach eil a' cleachdadh briosgaidean, mar sin tha CORS fosgailte.

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

Paramadairean

Sgàilean agus tomhas-lìonaidh

Tha meud eadar-dhealaichte aig gach sgàile (bytes UTF-8). Cleachd square airson susbaint fhada; obraichidh cumadh sam bith airson ceanglaichean goirid.

MCP — leig leis an AI a dhèanamh

Ceangail e ri neach-dèilig AI leithid Claude agus nì e còdan dìreach sa chòmhradh. 'S e https://mcp.wiacode.com/mcp an ceann-uidhe agus chan eil iuchair a dhìth.

Suidheachadh Claude Desktop

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

Ma tha do neach-dèilig a' toirt taic dhìreach do Streamable HTTP, thoir dha an URL a-mhàin.

Innealan

Crìochan an-asgaidh

• 10 iarrtasan sa mhionaid airson gach IP. Sin na dh'fhaodas tu cleachdadh sa bhad gun iuchair.
• Bheir aon chòd suas ri mu 4 diogan — sgrùdaidh am frithealaiche gu bheil an còd a rinn e comasach air a leughadh mus cuir e air ais e.
• Nuair a bhios iarrtasan a' cruinneachadh, feitheamh am frithealaiche greis is an uairsin freagraidh e 503. Cuir fios a-rithist a dh'aithghearr.
• Os cionn na crìche gheibh thu 429 còmhla ri cia mheud diog ri feitheamh.

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.

Barrachd

• Dè th' ann an WIA Code? — do dhaoine (agus AI) a tha faighneachd dè th' anns a' chòd seo
• Gineadair — dèan fear nad bhrabhsair
• Sganair — leugh fear gun dad a stàladh
• Luchd-saothrachaidh · Gealladh fosgailte OEM — faigh seachad air an deuchainn cho-fhreagarrachd agus faodaidh duine sam bith a amalachadh, an-asgaidh o dhleastanasan-ùghdarrais
• A' amalachadh WIA Code ann an sganair a th' ann mu thràth — airson sgiobaidhean POS, cioscaichean, agus SDK sganair

Tha WIA Code na thoradh aig SmileStory Co., Ltd. Tha an QR neartachaidh na iùl a chuidicheas daoine gun an sganair sònraichte a leughadh cuideachd.