توسعه‌دهندگان — 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 یا نسخه‌های جدیدتر اجرا می‌شود، بدون نیاز به نصب. هیچ وابستگی‌ای ندارد، پس دریافت آن چند ثانیه بیشتر طول نمی‌کشد.

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 / 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 بدهید و password را حذف کنید. فیلدهای گم‌شده یا نادرست با پاسخ 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"}'

فراخوانی از مرورگر

می‌توانید آن را مستقیماً از یک وب‌اپ در هر خاستگاهی فراخوانی کنید. این یک 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 — بگذارید هوش مصنوعی آن را بسازد

آن را به یک کلاینت هوش مصنوعی مانند Claude متصل کنید تا کدها را درست در همان گفتگو بسازد. نشانی سرویس https://mcp.wiacode.com/mcp است و نیازی به کلید نیست.

راه‌اندازی Claude Desktop

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

اگر کلاینت شما مستقیماً از Streamable HTTP پشتیبانی می‌کند، فقط آدرس را به آن بدهید.

ابزارها

محدودیت‌های رایگان

• ۱۰ درخواست در دقیقه به ازای هر IP. این چیزی است که می‌توانید بی‌درنگ و بدون کلید استفاده کنید.
• ساخت یک کد تا حدود ۴ ثانیه طول می‌کشد — سرور پیش از بازگرداندن، بررسی می‌کند که کد ساخته‌شده واقعاً قابل خواندن باشد.
• وقتی درخواست‌ها انباشته می‌شوند، سرور کمی صبر می‌کند و سپس 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 چیست؟ — برای افراد (و هوش‌های مصنوعی) که می‌پرسند این کد چیست
• سازنده — یکی را در مرورگرتان بسازید
• اسکنر — بدون نصب چیزی یکی را بخوانید
• تولیدکنندگان · OEM — پیمان باز: هر کس آزمون انطباق را بگذراند می‌تواند آن را بدون حق امتیاز پیاده‌سازی کند
• یکپارچه‌سازی WIA Code در یک اسکنر موجود — برای تیم‌های POS، کیوسک و scanner SDK

WIA Code محصولی از SmileStory Co., Ltd. است. QR تقویت‌کننده راهنمایی است که به افرادی که اسکنر اختصاصی ندارند نیز کمک می‌کند آن را بخوانند.