Mga Developer — API · MCP · CLI

Gumawa ng WIA Code sa isang linya. Walang kailangang key sa loob ng libreng limitasyon.

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 — isang linya, walang install

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

Direktang tumatakbo sa Node 18 o mas bago, nang walang install. Walang dependencies, kaya ilang segundo lang ang pag-fetch nito.

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

Mga Uri — Wi-Fi, contact card, event

Tatlong handa nang gamitin. Hindi mo na kailangang buuin mismo ang mga string — ibigay mo lang ang mga field at bubuuin ng server ang karaniwang Wi-Fi / vCard / iCalendar content, kapareho nang eksakto, byte-for-byte, sa nililikha ng generator sa site na ito.

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

Mga Field

Ang oras ay nasa "2026-09-01 19:00" na format. Para sa bukas na Wi-Fi network, ilagay ang security=nopass at wag nang isama ang password. Ang nawawala o maling format na field ay magbabalik ng HTTP 400 na may mensaheng nagsasabi kung anong field ang problema — walang larawang ma-render, kaya ang maling request ay hindi kailanman kumukuha ng render slot.

Maramihan Nang Sabay

Isang linya bawat code. Kapag naabot ang rate limit, naghihintay ito at nagpapatuloy sa halip na huminto sa gitna, at iniuulat ang mga nabigong linya kasama ang tunay nilang line number.

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

Ang response ay image/png. Idagdag ang ?format=json para makuha ang base64 at metadata bilang JSON.

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

Pagtawag mula sa browser

Maaari mo itong tawagin nang direkta mula sa isang web app sa kahit anong origin. Isa itong pampublikong API na hindi gumagamit ng cookies, kaya bukas ang CORS.

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

Mga Parameter

Mga Silhouette at Kapasidad

Iba-iba ang kaya ng bawat silhouette (UTF-8 bytes). Gamitin ang square para sa mahabang content; kahit anong hugis ay gagana para sa maiikling link.

MCP — hayaang ang AI ang gumawa nito

Ikonekta ito sa AI client tulad ng Claude at gagawa ito ng mga code nang direkta sa usapan. Ang endpoint ay https://mcp.wiacode.com/mcp at walang kailangang key.

Pag-set up ng Claude Desktop

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

Kung direktang sinusuportahan ng client mo ang Streamable HTTP, ibigay lang ang URL.

Mga Tool

Mga Libreng Limitasyon

• 10 request bawat minuto kada IP. Iyan ang magagamit mo agad nang walang key.
• Umaabot ng hanggang 4 segundo ang isang code — sinusuri ng server na mababasa nga ang code na ginawa nito bago ito ibalik.
• Kapag nagtambak ang mga request, sandaling maghihintay ang server at sasagot ng 503. Tumawag lang ulit sa loob ng ilang sandali.
• Kapag lumampas sa limitasyon, makakakuha ka ng 429 kasama ang bilang ng segundong dapat hintayin.

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.

Higit Pa

• Ano ang WIA Code? — para sa mga tao (at AI) na nagtatanong kung ano ang code na ito
• Generator — gumawa ng isa sa iyong browser
• Scanner — magbasa ng isa nang walang kailangang i-install
• Mga Tagagawa · OEM — bukas na pangako: sinumang makapasa sa conformance test ay puwedeng mag-integrate nito, royalty-free
• Pag-integrate ng WIA Code sa umiiral nang scanner — para sa mga team ng POS, kiosk, at scanner SDK

Ang WIA Code ay produkto ng SmileStory Co., Ltd. Ang booster QR ay isang gabay na tumutulong sa mga taong walang dedicated scanner na mabasa rin ito.