ນັກພັດທະນາ — API · MCP · CLI

ສ້າງ WIA Code ໃນບັນທັດດຽວ. ບໍ່ຕ້ອງການກະແຈພາຍໃນຂອບເຂດຟຣີ.

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 — ບັນທັດດຽວ, ບໍ່ຕ້ອງຕິດຕັ້ງ

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

ເຮັດວຽກທັນທີໃນ Node 18 ຫຼືໃໝ່ກວ່າ, ບໍ່ຕ້ອງຕິດຕັ້ງ. ມັນບໍ່ມີ dependency ດັ່ງນັ້ນການດຶງມາໃຊ້ເວລາພຽງແຕ່ບໍ່ຈັກວິນາທີ.

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

ປະເພດ — Wi-Fi, ບັດຕິດຕໍ່, ກິດຈະກຳ

ສາມປະເພດທີ່ກຽມພ້ອມແລ້ວ. ທ່ານບໍ່ຈຳເປັນຕ້ອງປະກອບຂໍ້ຄວາມເອງ — ພຽງແຕ່ສົ່ງຟິວທັງຫຼາຍ ແລະ ເຊີບເວີຈະສ້າງເນື້ອຫາ Wi-Fi / vCard / iCalendar ມາດຕະຖານ ຄືກັນທຸກໄບທ໌ກັບສິ່ງທີ່ຕົວສ້າງຂອງເວັບໄຊທ໌ນີ້ຜະລິດອອກມາ.

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

ຟິວ

ເວລາຢູ່ໃນຮູບແບບ "2026-09-01 19:00". ສຳລັບເຄືອຂ່າຍ Wi-Fi ແບບເປີດ ໃຫ້ສົ່ງ security=nopass ແລະ ບໍ່ຕ້ອງໃສ່ລະຫັດຜ່ານ. ຟິວທີ່ຂາດຫາຍ ຫຼື ຜິດຮູບແບບຈະຖືກສົ່ງກັບມາເປັນ HTTP 400 ພ້ອມຂໍ້ຄວາມລະບຸຊື່ຟິວ — ຮູບພາບຈະບໍ່ຖືກສ້າງຂຶ້ນ ດັ່ງນັ້ນຄຳຮ້ອງຂໍທີ່ຜິດພາດຈະບໍ່ແກ່ງແຍ່ງບ່ອນສ້າງຮູບເລີຍ.

ຫຼາຍລາຍການພ້ອມກັນ

ໜຶ່ງແຖວຕໍ່ໜຶ່ງລະຫັດ. ເມື່ອຮອດຂີດຈຳກັດອັດຕາ ມັນຈະລໍຖ້າແລ້ວດຳເນີນຕໍ່ ແທນທີ່ຈະຢຸດເຄິ່ງທາງ ແລະ ຈະລາຍງານແຖວທີ່ລົ້ມເຫຼວພ້ອມກັບເລກແຖວທີ່ແທ້ຈິງ.

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

ຄຳຕອບແມ່ນ image/png. ເພີ່ມ ?format=json ເພື່ອຮັບ base64 ແລະ metadata ເປັນ JSON.

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

ການເອີ້ນຈາກບຣາວເຊີ

ທ່ານສາມາດເອີ້ນມັນໄດ້ໂດຍກົງຈາກເວັບແອັບຢູ່ origin ໃດກໍໄດ້. ມັນເປັນ API ສາທາລະນະທີ່ບໍ່ໃຊ້ cookie, ດັ່ງນັ້ນ 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

ພາຣາມິເຕີ

ຮູບຮ່າງ ແລະ ຄວາມຈຸ

ແຕ່ລະຮູບຮ່າງເກັບປະລິມານທີ່ແຕກຕ່າງກັນ (byte UTF-8). ໃຊ້ square ສຳລັບເນື້ອຫາຍາວ; ຮູບຮ່າງໃດກໍໄດ້ໃຊ້ໄດ້ກັບລິ້ງສັ້ນ.

MCP — ໃຫ້ AI ສ້າງໃຫ້

ເຊື່ອມຕໍ່ມັນກັບລູກຄ້າ AI ເຊັ່ນ Claude ແລະມັນຈະສ້າງລະຫັດຢູ່ໃນການສົນທະນາເລີຍ. Endpoint ແມ່ນ https://mcp.wiacode.com/mcp ແລະບໍ່ຕ້ອງການກະແຈ.

ການຕັ້ງຄ່າ Claude Desktop

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

ຖ້າລູກຄ້າຂອງທ່ານຮອງຮັບ Streamable HTTP ໂດຍກົງ, ພຽງແຕ່ໃຫ້ URL ແກ່ມັນ.

ເຄື່ອງມື

ຂອບເຂດຟຣີ

• 10 ຄຳຮ້ອງຂໍຕໍ່ນາທີຕໍ່ IP. ນັ້ນແມ່ນສິ່ງທີ່ທ່ານສາມາດໃຊ້ໄດ້ທັນທີໂດຍບໍ່ຕ້ອງມີກະແຈ.
• ລະຫັດໜຶ່ງໃຊ້ເວລາເຖິງປະມານ 4 ວິນາທີ — ເຊີບເວີກວດເບິ່ງວ່າລະຫັດທີ່ສ້າງຂຶ້ນສາມາດອ່ານໄດ້ແທ້ໆກ່ອນທີ່ຈະສົ່ງມັນກັບຄືນ.
• ເມື່ອຄຳຮ້ອງຂໍສະສົມ, ເຊີບເວີຈະລໍຖ້າສັ້ນໆ ແລ້ວຕອບກັບ 503. ພຽງແຕ່ລອງໃໝ່ອີກຄັ້ງໃນໄວໆນີ້.
• ເກີນຂອບເຂດທ່ານຈະໄດ້ຮັບ 429 ພ້ອມກັບຈຳນວນວິນາທີທີ່ຕ້ອງລໍຖ້າ.

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.

ເພີ່ມເຕີມ

• WIA Code ແມ່ນຫຍັງ? — ສຳລັບຄົນ (ແລະ AI) ທີ່ຖາມວ່າລະຫັດນີ້ແມ່ນຫຍັງ
• ຕົວສ້າງ — ສ້າງອັນໜຶ່ງໃນບຣາວເຊີຂອງທ່ານ
• ຕົວສະແກນ — ອ່ານອັນໜຶ່ງໂດຍບໍ່ຕ້ອງຕິດຕັ້ງຫຍັງເລີຍ
• ຜູ້ຜະລິດ · ຄຳໝັ້ນສັນຍາເປີດສຳລັບ OEM — ຜ່ານການທົດສອບຄວາມສອດຄ່ອງແລ້ວໃຜກໍສາມາດເອົາໄປໃຊ້ໄດ້ໂດຍບໍ່ເສຍຄ່າລິຂະສິດ
• ການເຊື່ອມ WIA Code ເຂົ້າກັບເຄື່ອງສະແກນທີ່ມີຢູ່ແລ້ວ — ສຳລັບທີມ POS, ຄີອອດ, ແລະ SDK ເຄື່ອງສະແກນ

WIA Code ແມ່ນຜະລິດຕະພັນຂອງ SmileStory Co., Ltd. booster QR ແມ່ນຄູ່ມືທີ່ຊ່ວຍໃຫ້ຄົນທີ່ບໍ່ມີເຄື່ອງສະແກນສະເພາະສາມາດອ່ານມັນໄດ້ຄືກັນ.