개발자 — API · MCP · CLI

코드 한 줄로 WIA Code를 만듭니다. 무료 상한 안에서는 키 없이 바로 씁니다.

부스터 QR은 항상 포함됩니다. 끄는 옵션이 없습니다 — API·MCP·CLI 모두 같습니다. "누적 사용 1억 번에 이르면 부스터가 분리되고 그 자리에 원하는 로고가 들어간다"가 제품의 약속이라, 어느 한 경로에만 예외를 만들지 않았습니다. 인코딩 파라미터(grid·bpc·bridge)도 서버가 고정합니다.

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

Types — Wi-Fi, contact card, event

Three ready-made kinds. You do not have to assemble the strings yourself — pass the fields and the server builds standard Wi-Fi / vCard / iCalendar content, byte-for-byte identical to what the generator on this site produces.

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

Fields

type	required	optional
wifi	ssid, password	security (WPA·WEP·nopass), hidden
card	name	org, tel, email
event	title, start	end, location, desc

Times are "2026-09-01 19:00". For an open Wi-Fi network pass security=nopass and omit the password. Missing or malformed fields come back as HTTP 400 with a message naming the field — no image is rendered, so a bad request never takes a render slot.

Many at once

One line per code. On a rate limit it waits and continues instead of stopping halfway, and reports failed lines with their real line numbers.

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와 메타를 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

파라미터

name	required	description
text	✓	담을 텍스트 또는 URL. 긴 URL은 먼저 줄이는 편이 좋습니다.
type	—	`wifi` · `card` · `event`. Given instead of `text` — the server assembles the standard string from the fields. See the Types section above.
shape	—	실루엣(기본 `heart`). 아래 표 참고.
cellPx	—	셀 한 칸의 픽셀(3~20, 기본 8). 클수록 이미지가 큽니다.
label	—	메타에 남는 라벨. 이미지에는 그리지 않습니다.

실루엣과 용량

실루엣마다 담을 수 있는 양이 다릅니다(UTF-8 바이트). 긴 내용은 square, 짧은 링크는 아무거나.

shape	bytes	shape	bytes
square	1450	heart	854
bubble	1098	clover	521
round	1093	star	386
hex	861	boomerang	386

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만 넣으면 됩니다.

도구

tool	what it does
get_wia_code_info	WIA Code가 무엇인지, QR과 뭐가 다른지, 실루엣별 용량은 얼마인지 알려줍니다. 만들기 전에 먼저 부르면 실패가 줄어듭니다.
generate_wia_code	텍스트를 코드 이미지로 만듭니다. 용량을 넘으면 어떤 실루엣이면 담기는지 알려줍니다.
generate_wia_code_wifi	Wi-Fi credentials — scanning joins the network without typing the password.
generate_wia_code_card	A contact as a standard vCard — scanning offers to save it to the phone's contacts.
generate_wia_code_event	An event as standard iCalendar — scanning adds it to the calendar.

무료 상한

IP당 분당 10회. 키 없이 바로 쓸 수 있는 범위입니다.
생성 1건에 최대 4초쯤 걸립니다 — 만든 코드가 스스로 읽히는지 서버가 매번 확인하고 내보내기 때문입니다.
동시 요청이 몰리면 잠시 기다렸다가 503으로 답합니다. 잠시 후 다시 부르면 됩니다.
상한을 넘으면 429와 함께 몇 초 뒤에 다시 하면 되는지 알려줍니다.

더 많이 쓰셔야 한다면 — 대량 발급·제휴·상용 도입은 메일로 알려주세요. 키를 드리면 상한이 올라갑니다. wiasoom@smilestory.ai