Хөгжүүлэгчдэд — 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 байна. base64 болон метадатаг JSON хэлбэрээр авахын тулд ?format=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 дээрх веб аппликейшнээс шууд дуудаж болно. Энэ нь cookie ашигладаггүй нийтийн API учраас 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

Параметрүүд

Дүрсүүд ба багтаамж

Дүрс бүр өөр өөр хэмжээ (UTF-8 байт) багтаадаг. Урт агуулгад square-г ашиглана уу; богино холбоосонд ямар ч хэлбэр тохирно.

MCP — AI-аар үүсгүүл

Claude зэрэг AI клиенттэй холбоход, тэр яриан дотор нь шууд код үүсгэдэг. Төгсгөлийн цэг нь https://mcp.wiacode.com/mcp бөгөөд түлхүүр шаардлагагүй.

Claude Desktop-ийн тохиргоо

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

Хэрэв таны клиент Streamable HTTP-г шууд дэмждэг бол зүгээр л URL-г нь өгнө үү.

Хэрэгслүүд

Үнэгүй хязгаар

• IP тус бүрт минутанд 10 хүсэлт. Түлхүүргүйгээр шууд ашиглах боломжтой нь энэ юм.
• Нэг код бэлдэхэд ойролцоогоор 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.-ийн бүтээгдэхүүн юм. Бустер QR нь тусгай сканнергүй хүмүүст ч түүнийг унших боломжийг олгодог удирдамж юм.