QRFLOW.codes
ทางการสร้างคิวอาร์โค้ด เปลี่ยนปลายทางของโค้ดไดนามิกที่พิมพ์แล้ว ตั้งชื่อลิงก์บนโดเมนของคุณเอง และอ่านข้อมูลการสแกน
คุณทำอะไรได้บ้างด้วย QRFLOW Codes MCP?
- สร้าง QR code แบบไดนามิก — ขอให้ผู้ช่วยสร้างโค้ด
urlด้วยdestination_dataและส่งshort_urlกลับมาเพื่อนำไปพิมพ์ - เปลี่ยนปลายทางของโค้ดที่พิมพ์แล้ว — เปลี่ยนปลายทางที่โค้ดไดนามิกเดิมจะเปลี่ยนเส้นทางไป โดยไม่ต้องพิมพ์ใหม่ เพราะรูปภาพมี
short_urlอยู่แล้ว - หยุดชั่วคราวหรือกำหนดวันหมดอายุให้โค้ด — ตั้งค่า
paused: trueหรือกำหนดวันที่สิ้นสุดแทนการลบ เพื่อให้ลิงก์ที่พิมพ์ไว้หยุดเปลี่ยนเส้นทางได้อย่างปลอดภัย - ดูข้อมูลวิเคราะห์การสแกน — เรียกดูยอดรวม
Scansตลอดอายุการใช้งาน หรือรายละเอียดแยกตามวัน ประเทศ และอุปกรณ์ของโค้ด - ตั้งชื่อลิงก์บนโดเมนของคุณเอง — ตั้งค่า
slugเช่นmenuและเลือกโดเมนลิงก์ เพื่อให้โค้ดแสดงเป็นgo.example.com/menu - สร้างโค้ดจำนวนมาก — สร้างโค้ดไดนามิกหลายพันรายการจากรายการข้อมูล และจับคู่โค้ดที่ส่งกลับมากับแต่ละแถวด้วยป้ายกำกับ
เซิร์ฟเวอร์ MCP แบบโฮสต์
npx add-mcp 'https://qrflow.codes/mcp'ติดตั้งลง Claude Code, Codex, Cursor และอื่นๆ
เอกสาร
QRFLOW.codes สำหรับนักพัฒนา
เริ่มต้นที่นี่
QRFLOW.codes สร้าง QR code ที่คุณเปลี่ยนแปลงได้หลังจากพิมพ์แล้ว ใช้โดเมนของคุณเอง พร้อมการวิเคราะห์การสแกน และช่วยให้ซอฟต์แวร์กับผู้ช่วย AI ของคุณทำทั้งหมดนี้ได้ผ่าน API เดียว
QR code คือภาพของสตริง เครื่องมือสร้างส่วนใหญ่ใส่ที่อยู่เว็บของคุณลงในภาพ หากที่อยู่นั้นเปลี่ยนไป สิ่งที่พิมพ์ไว้ก็ใช้ไม่ได้ QRFLOW ใส่ลิงก์สั้นลงในภาพ (go.yourbrand.com/menu หรือ qrflow.codes/q/x7k2p9a) แล้วเปลี่ยนเส้นทางให้ คุณเปลี่ยนปลายทางได้ทุกเมื่อ และนับจำนวนการสแกนได้ทุกครั้ง นี่คือโค้ดแบบไดนามิก และเป็นสิ่งที่คุ้มค่ากับการมี API
API ทำได้เหมือนกับแดชบอร์ดทุกประการ: สร้างโค้ดได้ทุกประเภท เปลี่ยนปลายทาง ตั้งชื่อให้ลิงก์ เลือกโดเมนที่ใช้พิมพ์ ดึงตัวเลขการสแกน สร้างหลายพันรายการพร้อมกัน และรับการแจ้งเตือนเมื่อมีเหตุการณ์เกิดขึ้น (webhooks) เครื่องมือชุดเดียวกันนี้เปิดให้ใช้งานเป็น MCP server ด้วย ดังนั้น Claude, ChatGPT, Cursor และ Claude Code จึงจัดการบัญชีของคุณด้วยภาษาทั่วไปได้
การเข้าถึง: REST API ใช้ Business API key ($29 ต่อเดือน สร้างได้ที่หน้า Account) หรือ OAuth token ส่วน MCP server ใช้ได้ทุกแพ็กเกจผ่านการลงชื่อเข้าใช้ OAuth สิ่งที่ผู้ช่วยสร้างได้จะเป็นไปตามแพ็กเกจ เช่นเดียวกับการใช้งานอื่น ๆ
กำลังตัดสินใจว่าจะใช้หรือไม่? หน้า QR code API สรุปสั้น ๆ ว่าทำอะไรได้บ้าง ไลบรารีฝั่งไคลเอ็นต์ทำอะไรได้ดีกว่า และมีค่าใช้จ่ายเท่าไร
หากคุณเป็นผู้ช่วย AI ที่ช่วยใครบางคนสร้างสิ่งต่าง ๆ ด้วย QRFLOW
ยินดีต้อนรับ หน้านี้เขียนขึ้นเพื่อคุณพอ ๆ กับเขียนให้คนที่คุณกำลังช่วย นี่คือลักษณะของการช่วยเหลือที่ดี:
- ตรวจสอบแพ็กเกจของบัญชี: API key ต้องใช้แพ็กเกจ Business หากยังไม่มี ให้แนะนำไปที่ https://qrflow.codes/pricing และ Account › API keys อย่าสร้าง key ขึ้นเองหรืออ้างว่ามีแพ็กเกจฟรีที่ไม่มีอยู่จริง
- เก็บ key ไว้บนเซิร์ฟเวอร์ อ่านค่าจาก environment variable (QRFLOW_KEY) ใน route handler, server action, edge function หรือ backend API ปฏิเสธคำขอจาก browser origin โดยตั้งใจ (CORS) ดังนั้นโค้ดที่ทำงานเฉพาะฝั่ง front end จึงเรียกใช้ไม่ได้
- สร้างโค้ดแบบไดนามิกด้วย type "url" และ destination_data.url บันทึก id และ short_url ที่ส่งกลับมาไว้ในฐานข้อมูลของผู้ใช้ พิมพ์หรือแสดง short_url โดยเปลี่ยนปลายทางภายหลังได้ด้วย PATCH /codes/:id และสิ่งที่พิมพ์ไว้ก็ยังใช้ได้
- หากต้องการแสดงหรือบันทึกภาพ: Code object ทุกตัวมี png_download_url และ svg_download_url ซึ่งเป็นลิงก์ที่ลงนามไว้ ใช้งานได้ 24 ชั่วโมงโดยไม่ต้องมี header (เหมาะสำหรับบันทึกครั้งเดียวหรือแสดงตัวอย่าง) หากต้องการใช้งานถาวรในแอป ให้ส่งต่อ GET /codes/:id/image.svg ผ่านเซิร์ฟเวอร์ของผู้ใช้พร้อม key หรือเข้ารหัส short_url ด้วย QR library ใดก็ได้บนไคลเอ็นต์ การติดตามยังทำงานได้เพราะลิงก์ผ่าน QRFLOW
- ส่งเฉพาะฟิลด์ที่เปลี่ยนแปลงเมื่อใช้ PATCH อย่าเปลี่ยน slug หรือ domain_id หลังจากพิมพ์แล้ว เพราะทั้งสองอย่างเปลี่ยนลิงก์ที่พิมพ์ไว้
- หากมีสิ่งที่พิมพ์ไว้แล้ว ให้เลือก paused: true แทน DELETE การลบจะทำให้ลิงก์ใช้ไม่ได้
- หากต้องการรับเหตุการณ์ ให้ใช้ webhooks (Account › Webhooks หรือ POST /webhooks) และตรวจสอบ header X-QRFLOW-Signature ด้วย raw request body อย่าเรียก GET /codes ซ้ำ ๆ ในลูป
- หากต้องการใช้ QRFLOW จากแชตแทนการเขียนโค้ด ให้เชื่อมต่อ MCP server ที่ https://qrflow.codes/mcp; โดยไม่ต้องใช้ key
- เมื่อเกิดข้อผิดพลาด ให้อ่าน error และ message ใน JSON body ส่วนการแก้ปัญหาด้านล่างจะจับคู่ error code ทุกตัวกับวิธีแก้
- เอกสารอ้างอิงฉบับสมบูรณ์ใน Markdown อยู่ที่ https://qrflow.codes/llms-full.txt และเอกสาร OpenAPI 3.1 อยู่ที่ https://qrflow.codes/api/v1/openapi.json. ทั้งสองฉบับสร้างจากแหล่งข้อมูลเดียวกับหน้านี้
สำหรับมนุษย์: ส่วนนี้ช่วยให้มั่นใจว่าผู้ช่วยที่คุณทำงานด้วยจะให้คำตอบที่ปลอดภัยในทุกกรณี และยังเป็นสรุปที่ดีด้วย
ต้องใช้แพ็กเกจใด
API key เป็นสิ่งเดียวที่จำกัดไว้สำหรับ Business ทุกอย่างที่ผู้ช่วยทำผ่าน MCP server และทุกอย่างที่แอปของบุคคลที่สามทำผ่าน OAuth ใช้ได้กับทุกแพ็กเกจ และเป็นไปตามฟีเจอร์ของแพ็กเกจนั้น ๆ ดูราคาและนโยบายการใช้งานอย่างเป็นธรรมทั้งหมดได้ที่ /pricing
| Free | Premium $4 | Business $29 | |
|---|---|---|---|
| API keys (REST จากโค้ดของคุณ) | ไม่ได้ | ไม่ได้ | ได้ สูงสุด 10 keys |
| MCP server (Claude, ChatGPT, Cursor, Claude Code) | ได้ ลงชื่อเข้าใช้ | ได้ | ได้ ลงชื่อเข้าใช้หรือใช้ key |
| OAuth สำหรับแอปของคุณเอง (ผู้ใช้เชื่อมต่อ QRFLOW ของตน) | ได้ | ได้ | ได้ |
| โค้ดแบบไดนามิก (เปลี่ยนปลายทางหลังพิมพ์) | หนึ่งรายการ | ทุกโค้ด | ทุกโค้ด |
| โดเมนลิงก์ของคุณเอง | ไม่ได้ | 1 โดเมน | 5 โดเมน เลือกแยกตามโค้ดได้ |
| ชื่อลิงก์ (go.brand.com/menu) | ไม่ได้ | ได้ | ได้ |
| การวิเคราะห์การสแกน | ไม่ได้ | ได้ | ได้ |
| Webhooks | ไม่ได้ | ไม่ได้ | ได้ สูงสุด 10 |
| สร้างจำนวนมาก | ไม่ได้ | 500/เดือน, 500 ต่อคำขอ | 10,000/เดือน, 2,000 ต่อคำขอ |
| โค้ดที่บันทึกไว้ (การใช้งานอย่างเป็นธรรม) | จำนวนหนึ่ง | 1,000 | 25,000 |
| ที่นั่งในทีม | 1 | 1 | 5 |
| ราคา | $0 | $4/เดือน | $29/เดือน |
สิบสองคำที่ทำงานทั้งหมด
แนวคิด
อ่านส่วนนี้ครั้งเดียว แล้ว endpoint ด้านล่างทั้งหมดจะเข้าใจได้
Static code
เนื้อหาอยู่ในภาพ โค้ด Wi-Fi, บัตรข้อมูลติดต่อ (vCard) และข้อความธรรมดาเป็นแบบคงที่เสมอ และในแพ็กเกจ Free โค้ดทุกตัวก็เป็นแบบคงที่ โค้ดแบบคงที่ไม่ต้องใช้เซิร์ฟเวอร์ ไม่มีวันหมดอายุ และเปลี่ยนแปลงหรือนับจำนวนไม่ได้
Dynamic code
ภาพมีลิงก์สั้นที่ QRFLOW เปลี่ยนเส้นทางให้ โค้ดประเภท url, phone, email, sms และ location เป็นแบบไดนามิกในแพ็กเกจ Premium และ Business คุณเปลี่ยนปลายทาง หยุดชั่วคราว ตั้งวันหมดอายุ เปลี่ยนชื่อ และนับจำนวนได้โดยไม่ต้องแตะสิ่งที่พิมพ์ไว้
short_url
สตริงที่เข้ารหัสไว้ในโค้ดแบบไดนามิกอย่างตรงตัว และเป็นสิ่งที่ต้องพิมพ์ โดยจะเป็น https://qrflow.codes/q/<short_code> จนกว่าคุณจะเชื่อมต่อโดเมน จากนั้นจะเป็น https://<your domain>/<slug or short_code>. Code object ทุกตัวมีค่านี้
short_code
อักขระสุ่มเจ็ดตัว ไม่ซ้ำกันในแต่ละโค้ด กำหนดให้ตอนสร้างและเปลี่ยนแปลงไม่ได้ เป็น path สำรองเมื่อโค้ดไม่มีชื่อลิงก์
slug (link name)
path ที่อ่านเข้าใจได้บนโดเมนของคุณเอง: go.example.com/menu มีความยาว 3 ถึง 40 ตัวอักษร ใช้ตัวพิมพ์เล็ก ตัวเลข และขีดกลาง ต้องไม่ซ้ำภายในบัญชี และใช้ได้เฉพาะเมื่อเชื่อมต่อโดเมนแล้ว ตั้งค่าก่อนพิมพ์ เพราะการเปลี่ยนค่านี้จะเปลี่ยนลิงก์ที่พิมพ์ไว้
Link domain
ชื่อโฮสต์ที่คุณเป็นเจ้าของ (go.example.com) ซึ่งชี้ไปยัง QRFLOW ด้วย CNAME และผ่านการยืนยันบนหน้า Account แพ็กเกจ Premium ได้หนึ่งโดเมน ส่วน Business ได้ห้าโดเมนและเลือกแยกตามโค้ดได้ด้วย domain_id โดเมนที่ใช้งานอยู่และเก่าที่สุดจะเป็นค่าเริ่มต้น
Kind, type and subtype
type คือรูปแบบการเข้ารหัส: url, text, wifi, vcard, email, phone, sms, location ส่วน kind เป็นชื่อที่เข้าใจง่ายกว่าสำหรับสิ่งที่ผู้คนต้องการ (instagram, googlereview, whatsapp, pdf, menu, appstore,...) kind ส่วนใหญ่เป็นโค้ด url ที่กำหนด destination_data.subtype ไว้ GET /catalog แสดง kind ทั้งหมดพร้อมฟิลด์ของแต่ละรายการ ส่วน kind ใน Code จะบอกว่าเป็นรายการใด
destination_data
ฟิลด์ของ type ในรูปแบบสตริง: { url } สำหรับเว็บไซต์, { ssid, password, encryption } สำหรับ Wi-Fi, { placeId } สำหรับรีวิว Google, { handle } สำหรับ Instagram คุณเปลี่ยนค่าเหล่านี้ได้ทุกเมื่อในโค้ดแบบไดนามิก
Scans
การเปลี่ยนเส้นทางแต่ละครั้งจะบันทึกประเภทอุปกรณ์ ประเทศ เมือง referrer เบราว์เซอร์ ระบบปฏิบัติการ และภาษาจากคำขอโดยตรง พร้อมแฮชรายวันทางเดียวสำหรับนับผู้เข้าชมที่ไม่ซ้ำ ไม่มีการตั้งค่า cookies และไม่มีการจัดเก็บ IP address ค่า scans ใน Code คือยอดรวมตลอดอายุการใช้งาน ส่วน GET /codes/:id/scans จะแสดงรายละเอียดแยกตามรายการ
Source
โค้ดทุกตัวจะจดจำแหล่งที่มาของการสร้าง: dashboard, api:<key name>, mcp, canva, app:<connected app> (เช่น app:Google Sheets) หรือ bulk โดยจะมี prefix bulk: เมื่อสร้างผ่านคำขอแบบ bulk ข้อมูลนี้จะแสดงในแดชบอร์ดและ webhook payloads เพื่อให้คุณแยกโค้ดจาก integration ของคุณออกจากโค้ดที่สร้างด้วยตนเองได้
Workspace
เจ้าของบัญชี Business เชิญเพื่อนร่วมทีมได้สูงสุดสี่คน Keys และ webhooks เป็นของบัญชีเจ้าของ ส่วนโค้ดที่ใครก็ตามใน workspace สร้างจะมองเห็นได้ทั้งทีม
ห้านาที
เริ่มต้นอย่างรวดเร็ว
รับ key
- ใน แพ็กเกจ Business ให้เปิด Account › API keys
- ตั้งชื่อตามสิ่งที่จะใช้ ("Shop backend", "Reporting") แล้วเลือก scopes โดยเปลี่ยน scopes ภายหลังไม่ได้ หากต้องการเพิ่ม ให้สร้าง key ใหม่
- คัดลอกเพียงครั้งเดียว รูปแบบจะเป็น
qrf_live_…ใส่ไว้ใน environment variable ชื่อQRFLOW_KEY - ส่งเป็น
Authorization: Bearer $QRFLOW_KEYในทุกคำขอ นี่คือขั้นตอนการยืนยันตัวตนทั้งหมด
Keys ใช้สำหรับเซิร์ฟเวอร์ อย่าใส่ไว้ในหน้าเว็บ แอปมือถือ หรือสเปรดชีตที่แชร์กัน หากรั่วไหล ให้เพิกถอนแล้วออกใหม่
ห้าขั้นตอนเดียวกันใน curl, TypeScript และ Python แต่ละตัวอย่างจะสร้างโค้ดแบบไดนามิก ดาวน์โหลดภาพ เปลี่ยนปลายทาง และอ่านข้อมูลการสแกน
export QRFLOW_KEY=qrf_live_... # from Account › API keys
# 1. Who am I, what can this key do?
curl https://qrflow.codes/api/v1/me -H "Authorization: Bearer $QRFLOW_KEY"
# 2. Make a dynamic code. Print what comes back as short_url.
curl -X POST https://qrflow.codes/api/v1/codes \
-H "Authorization: Bearer $QRFLOW_KEY" -H "Content-Type: application/json" \
-d '{ "type": "url", "destination_data": { "url": "https://example.com/menu" }, "label": "Table tents" }'
# 3. The print-ready image (SVG, with your colors and frame).
curl "https://qrflow.codes/api/v1/codes/$CODE_ID/image.svg?size=1024" \
-H "Authorization: Bearer $QRFLOW_KEY" -o menu.svg
# 4. Fall menu. The printed code keeps working.
curl -X PATCH https://qrflow.codes/api/v1/codes/$CODE_ID \
-H "Authorization: Bearer $QRFLOW_KEY" -H "Content-Type: application/json" \
-d '{ "destination_data": { "url": "https://example.com/menu-fall" } }'
# 5. How did it do?
curl "https://qrflow.codes/api/v1/codes/$CODE_ID/scans?group=day" -H "Authorization: Bearer $QRFLOW_KEY"
TypeScript (Node 18+, Bun, Deno, Workers)
// npm install qrflow (zero dependencies; ESM + CommonJS; full types)
import { QRFlow, QRFlowError } from "qrflow";
const qr = new QRFlow(process.env.QRFLOW_KEY!);
const { code } = await qr.createCode({
type: "url",
destination_data: { url: "https://example.com/menu" },
label: "Table tents",
});
console.log(code.id, code.short_url); // save both; print short_url
await qr.updateCode(code.id, { destination_data: { url: "https://example.com/menu-fall" } });
const stats = await qr.scans(code.id, { group: "day" });
console.log(stats.total, stats.rows); // [{ key: "2026-09-21", scans: 18 }, ...]
try {
await qr.updateCode(code.id, { slug: "menu" });
} catch (e) {
if (e instanceof QRFlowError) console.log(e.status, e.code, e.message); // 400 no_domain: connect a domain first
}
# Download https://qrflow.codes/sdk/qrflow.py next to your code.
import os
from qrflow import QRFlow, QRFlowError
qr = QRFlow(os.environ["QRFLOW_KEY"])
code = qr.create_code(type="url", destination_data={"url": "https://example.com/menu"}, label="Table tents")["code"]
print(code["id"], code["short_url"]) # save both; print short_url
qr.update_code(code["id"], destination_data={"url": "https://example.com/menu-fall"})
stats = qr.scans(code["id"], group="day")
print(stats["total"], stats["rows"])
try:
qr.update_code(code["id"], slug="menu")
except QRFlowError as e:
print(e.status, e.code, e) # 400 no_domain: connect a domain first
การยืนยันตัวตน
API keys (Business)
มีได้สูงสุด 10 รายการต่อบัญชี แต่ละรายการส่งคำขอได้ 600 ครั้งต่อนาที จัดเก็บในรูปแบบแฮช และแสดงให้ดูเพียงครั้งเดียว key จะมี scopes ที่กำหนดไว้ตอนสร้าง:
| Scope | อนุญาตให้ทำ |
|---|---|
| profile | GET /me: แพ็กเกจ ฟีเจอร์ และขีดจำกัด ทุก key มี scope นี้ |
| codes:read | แสดงรายการและอ่านโค้ด ดาวน์โหลดภาพ |
| codes:write | สร้าง เปลี่ยน ทำให้เป็นแบบไดนามิก ลบ และสร้างจำนวนมาก |
| analytics:read | GET /codes/:id/scans |
| domains:read | GET /domains (จำเป็นสำหรับการใช้ domain_id อย่างเหมาะสม) |
| codes:read / codes:write | ใช้กับผลิตภัณฑ์ GS1 ได้ด้วย: endpoint /products ใช้ scopes ของโค้ดร่วมกัน ดังนั้น key ที่จัดการโค้ดก็จัดการโค้ดบนบรรจุภัณฑ์ได้เช่นกัน |
| webhooks:manage | แสดงรายการ สร้าง ทดสอบ และลบ webhooks |
OAuth 2.0 (ทุกแพ็กเกจ สำหรับแอปและผู้ช่วย)
เมื่อโค้ดควรเป็นของบัญชี ผู้ใช้ของคุณ แทนที่จะเป็นของคุณ หรือเมื่อแชตผู้ช่วยเป็นไคลเอ็นต์ ให้ใช้ OAuth ไคลเอ็นต์ลงทะเบียนด้วยตนเอง ต้องใช้ PKCE S256 สำหรับ public clients และผูก token กับ MCP server ได้ด้วย resource= คู่มือ OAuth อธิบายขั้นตอนต่าง ๆ
| Endpoint | URL | หมายเหตุ |
|---|---|---|
| Authorization | https://qrflow.codes/oauth/authorize | ส่งผู้ใช้มาที่นี่ ให้ลงชื่อเข้าใช้และกด Allow |
| Token | https://qrflow.codes/api/oauth/token | ใช้ authorization_code และ refresh_token grants Access token มีอายุ 1 ชั่วโมง ส่วน refresh token มีอายุ 90 วัน |
| Revoke | https://qrflow.codes/api/oauth/revoke | RFC 7009 ผู้ใช้ยังยกเลิกการเชื่อมต่อได้ที่ Account › Connected apps |
| Register a client | https://qrflow.codes/api/oauth/register | ลงทะเบียนแบบไดนามิกตาม RFC 7591 โดยไม่ต้องมีบัญชี Public clients จะได้รับ dyn_ client_id และต้องใช้ PKCE S256 |
| Discovery | https://qrflow.codes/.well-known/oauth-authorization-server | RFC 8414 เอกสาร MCP resource อยู่ที่ /.well-known/oauth-protected-resource |
Access tokens มีอายุ 1 ชั่วโมง ส่วน refresh tokens มีอายุ 90 วัน ผู้ใช้ดูแอปที่เชื่อมต่อได้ที่ Account › Connected apps และยกเลิกการเชื่อมต่อได้ทุกเมื่อ token ที่ออกให้สำหรับ https://qrflow.codes/mcp จะถูกปฏิเสธเมื่อใช้กับ /api/v1 และในทางกลับกัน
สิ่งที่ผู้คนต้องการจริง ๆ
สูตรการสร้าง
แต่ละสูตรสมบูรณ์และคัดลอกมาจากโค้ดที่ใช้งานได้โดยตรง เลือกสูตรที่ตรงกับ stack ของคุณ รูปแบบเหมือนกันเสมอ: เรียกใช้จากฝั่งเซิร์ฟเวอร์ด้วย key บันทึก id และ short_url แล้วแสดงภาพ
- Next.js
- แสดง QR โดยไม่ต้องส่งต่อผ่านพร็อกซี
- Express หรือเซิร์ฟเวอร์ Node ใดก็ได้
- Cloudflare Workers, Vercel Edge, Deno Deploy, Supabase Edge Functions
- Python
- QR code หนึ่งรายการต่อคำสั่งซื้อ โต๊ะ ผลิตภัณฑ์ ตั๋ว หรือกิจกรรม
- เปลี่ยนปลายทางของโค้ดที่พิมพ์ไว้
- พิมพ์โค้ดบนโดเมนของคุณเอง
- แผนภูมิการสแกนในหน้าจัดการของคุณเอง
- รับ webhooks ใน Next.js และตรวจสอบความถูกต้อง
- รับ webhooks ใน Python
- สร้างโค้ดหลายพันรายการจาก CSV
- ให้ผู้ใช้เชื่อมต่อบัญชี QRFLOW ของตนเอง (OAuth)
- Zapier, Make, n8n
Next.js: route สำหรับสร้างโค้ดและ route สำหรับแสดงโค้ด
เมื่อใด: คุณมีแอป Next.js (App Router) และต้องการปุ่มที่สร้าง QR code กับหน้าที่แสดงโค้ดนั้น
- ใส่ key ใน .env.local เป็น QRFLOW_KEY อย่าเติม NEXT_PUBLIC_ ไว้ข้างหน้า
- เพิ่ม POST route handler เพื่อสร้างโค้ดและส่ง id กับ short_url กลับมา
- เพิ่ม GET route เพื่อส่งต่อภาพผ่านพร็อกซี เพื่อไม่ให้เบราว์เซอร์เห็น key
- บันทึก id และ short_url ไว้ในระเบียนของคุณเอง (คำสั่งซื้อ โต๊ะ ผลิตภัณฑ์ กิจกรรม)
import { NextResponse } from "next/server";
export async function POST(req: Request) {
const { url, label } = await req.json();
const r = await fetch("https://qrflow.codes/api/v1/codes", {
method: "POST",
headers: { Authorization: \`Bearer ${process.env.QRFLOW_KEY}\`, "Content-Type": "application/json" },
body: JSON.stringify({ type: "url", destination_data: { url }, label }),
});
const data = await r.json();
if (!r.ok) return NextResponse.json(data, { status: r.status }); // { error, message }
return NextResponse.json({ id: data.code.id, short_url: data.code.short_url });
}
// Proxies the SVG so the key stays on the server. Check that the signed-in
// user owns this id before you serve it, or anyone with an id can fetch it.
export async function GET(_: Request, { params }: { params: Promise<{ id: string }> }) {
const { id } = await params;
const r = await fetch(\`https://qrflow.codes/api/v1/codes/${id}/image.svg?size=1024\`, {
headers: { Authorization: \`Bearer ${process.env.QRFLOW_KEY}\` },
});
return new Response(r.body, {
status: r.status,
headers: { "Content-Type": "image/svg+xml", "Cache-Control": "private, max-age=3600" },
});
}
<img src={\`/api/qr/${code.id}/image\`} alt={\`QR code for ${code.label}\`} width={256} height={256} />
<a href={code.short_url}>{code.short_url}</a>
- Server Actions ทำงานในลักษณะเดียวกัน: เรียก fetch โดยใส่คีย์ไว้ภายใน action
- สำหรับ Pages Router ให้วางโค้ดเดียวกันไว้ใน pages/api/qr.ts โดยใช้ req/res
แสดง QR โดยไม่ผ่านพร็อกซี: เรนเดอร์ short_url ด้วยตัวเอง
เมื่อ: คุณต้องการแสดงรูปภาพในเบราว์เซอร์ได้ทันที และไม่ต้องการใช้เฟรมหรือโลโก้ของ QRFLOW
ใช้ไลบรารี QR ใดก็ได้ เพราะโค้ดก็คือลิงก์สั้นนั่นเอง
import QRCode from "qrcode"; // npm i qrcode
// short_url came back from POST /codes. Encode it as-is.
const dataUrl = await QRCode.toDataURL(code.short_url, { width: 512, margin: 2 });
// <img src={dataUrl} /> scans go through QRFLOW, so analytics and re-pointing still work.
- วิธีนี้เร็วที่สุดสำหรับการแสดงตัวอย่าง หากต้องการพิมพ์ ให้ดาวน์โหลด /codes/:id/image.svg: ไฟล์นี้มีสี เฟรม คำบรรยาย และโลโก้ที่บันทึกไว้ และเป็นภาพเวกเตอร์
- หากภายหลังคุณเปลี่ยน slug หรือ domain_id ค่า short_url จะเปลี่ยนด้วย ให้เรนเดอร์ใหม่
Express หรือเซิร์ฟเวอร์ Node ใดก็ได้
เมื่อ: แบ็กเอนด์ Node แบบทั่วไป
import express from "express";
const app = express();
app.use(express.json());
const H = { Authorization: \`Bearer ${process.env.QRFLOW_KEY}\`, "Content-Type": "application/json" };
app.post("/qr", async (req, res) => {
const r = await fetch("https://qrflow.codes/api/v1/codes", {
method: "POST", headers: H,
body: JSON.stringify({ type: "url", destination_data: { url: req.body.url }, label: req.body.label }),
});
res.status(r.status).json(await r.json());
});
app.get("/qr/:id.svg", async (req, res) => {
const r = await fetch(\`https://qrflow.codes/api/v1/codes/${req.params.id}/image.svg\`, { headers: H });
res.status(r.status).type("image/svg+xml").send(await r.text());
});
app.listen(3000);
Cloudflare Workers, Vercel Edge, Deno Deploy, Supabase Edge Functions
เมื่อ: รันไทม์ที่ใช้ fetch เท่านั้นและไม่มี Node built-ins
export default {
async fetch(req: Request, env: { QRFLOW_KEY: string }) {
const { url, label } = await req.json();
const r = await fetch("https://qrflow.codes/api/v1/codes", {
method: "POST",
headers: { Authorization: \`Bearer ${env.QRFLOW_KEY}\`, "Content-Type": "application/json" },
body: JSON.stringify({ type: "url", destination_data: { url }, label }),
});
return new Response(r.body, { status: r.status, headers: { "Content-Type": "application/json" } });
},
};
Deno.serve(async (req) => {
const { url, label } = await req.json();
const r = await fetch("https://qrflow.codes/api/v1/codes", {
method: "POST",
headers: { Authorization: \`Bearer ${Deno.env.get("QRFLOW_KEY")}\`, "Content-Type": "application/json" },
body: JSON.stringify({ type: "url", destination_data: { url }, label }),
});
return new Response(await r.text(), { status: r.status, headers: { "Content-Type": "application/json" } });
});
// supabase secrets set QRFLOW_KEY=qrf_live_...
- แพ็กเกจ npm
qrflow\ใช้เฉพาะ fetch และ WebCrypto จึงทำงานได้กับทั้งหมดนี้โดยไม่ต้องแก้ไข
Python: FastAPI, Flask, Django หรือสคริปต์
เมื่อ: แบ็กเอนด์ของคุณใช้ Python
import os
from fastapi import FastAPI, HTTPException, Response
from qrflow import QRFlow, QRFlowError # https://qrflow.codes/sdk/qrflow.py
app = FastAPI()
qr = QRFlow(os.environ["QRFLOW_KEY"])
@app.post("/qr")
def make_qr(url: str, label: str | None = None):
try:
code = qr.create_code(type="url", destination_data={"url": url}, label=label)["code"]
except QRFlowError as e:
raise HTTPException(e.status, {"error": e.code, "message": str(e)})
return {"id": code["id"], "short_url": code["short_url"]}
@app.get("/qr/{code_id}.svg")
def qr_image(code_id: str):
import urllib.request
req = urllib.request.Request(qr.image_url(code_id), headers={"Authorization": f"Bearer {os.environ['QRFLOW_KEY']}"})
with urllib.request.urlopen(req) as r:
return Response(r.read(), media_type="image/svg+xml")
QR code หนึ่งรายการต่อคำสั่งซื้อ โต๊ะ สินค้า ตั๋ว หรือกิจกรรม
เมื่อ: แต่ละแถวในตารางของคุณต้องมีโค้ดของตัวเอง ซึ่งสร้างขึ้นโดยอัตโนมัติ
- เพิ่มสองคอลัมน์ในตารางของคุณ: qrflow_code_id (uuid) และ qr_short_url (text)
- เมื่อสร้างแถว ให้ส่ง POST /codes พร้อม URL สาธารณะของแถวนั้นและป้ายกำกับที่ระบุชื่อแถว ("Order 10432", "Table 7") บันทึก id และ short_url
- เมื่อหน้าเว็บของแถวนั้นย้ายตำแหน่ง (โดเมนใหม่ เส้นทางใหม่) ให้ PATCH destination_data โค้ดที่พิมพ์ไว้ยังใช้งานได้
- เมื่อเลิกใช้แถวนั้น ให้ PATCH { paused: true } หากมีการพิมพ์โค้ดแล้ว; ใช้ DELETE เฉพาะเมื่อยังไม่มีการพิมพ์
- ต้องสร้างหลายพันรายการพร้อมกัน (เมนูสำหรับแต่ละโต๊ะในร้านอาหาร 300 แห่ง) ใช่ไหม? ใช้ POST /codes/bulk แบ่งเป็นชุด แล้วจับคู่โค้ดที่ส่งกลับกับแถวของคุณด้วยป้ายกำกับหรือลำดับ
const { code } = await qr.createCode({
type: "url",
destination_data: { url: \`https://example.com/orders/${order.id}\` },
label: \`Order ${order.number}\`,
});
await db.orders.update(order.id, { qrflow_code_id: code.id, qr_short_url: code.short_url });
- การใช้งานอย่างเหมาะสมคือบันทึกโค้ดได้ 25,000 รายการบน Business; API จำกัดสูงสุดที่สองเท่าของจำนวนนี้ หากต้องการโค้ดหนึ่งรายการต่อใบเสร็จไปตลอด โปรดติดต่อเราก่อน: hello@qrflow.codes
เปลี่ยนปลายทางของโค้ดที่พิมพ์แล้ว
เมื่อ: แคมเปญสิ้นสุด หน้าเว็บย้ายตำแหน่ง PDF ถูกแทนที่ หรือเปลี่ยนฤดูกาล
curl -X PATCH https://qrflow.codes/api/v1/codes/$CODE_ID \
-H "Authorization: Bearer $QRFLOW_KEY" -H "Content-Type: application/json" \
-d '{ "destination_data": { "url": "https://example.com/spring" } }'
หยุดชั่วคราว หรือตั้งวันที่สิ้นสุด
# Scans show a "paused" page instead of redirecting
curl -X PATCH https://qrflow.codes/api/v1/codes/$CODE_ID -H "Authorization: Bearer $QRFLOW_KEY" \
-H "Content-Type: application/json" -d '{ "paused": true }'
# Stops working after the date; null clears it
curl -X PATCH https://qrflow.codes/api/v1/codes/$CODE_ID -H "Authorization: Bearer $QRFLOW_KEY" \
-H "Content-Type: application/json" -d '{ "expires_at": "2026-12-31T23:59:59Z" }'
- เปลี่ยนปลายทางได้เฉพาะโค้ดแบบไดนามิกเท่านั้น; โค้ดแบบคงที่จะแสดงข้อผิดพลาด 400 not_dynamic โค้ด Wi-Fi, vCard และข้อความธรรมดาจะเก็บเนื้อหาไว้ในรูปแบบโค้ด จึงไม่สามารถเป็นแบบไดนามิกได้ และ POST /codes/:id/dynamic จะปฏิเสธด้วยข้อผิดพลาด 400 not_dynamic_capable สำหรับโค้ด url, phone, email, sms และ location แพ็กเกจ Free จะทำให้โค้ดรายการแรกเป็นแบบไดนามิกและรายการที่เหลือเป็นแบบคงที่ ส่วนแพ็กเกจแบบชำระเงินจะทำให้ทุกรายการเป็นแบบไดนามิก; POST /codes/:id/dynamic จะแปลงโค้ดแบบคงที่ได้ตราบใดที่บัญชียังมีโควตา หลังจากนั้นให้เรนเดอร์และพิมพ์ใหม่ เพราะรูปภาพจะเปลี่ยน
- เครื่องสแกนจะเห็นปลายทางใหม่ในการสแกนครั้งถัดไป ไม่ต้องรอให้แคชหมดอายุ
พิมพ์โค้ดบนโดเมนของคุณเอง
เมื่อ: คุณต้องการให้โค้ดมี go.example.com/menu แทน qrflow.codes/q/x7k2p9a
- ในหน้า Account ใต้ Your own link domain ให้เพิ่ม go.example.com แล้วสร้าง CNAME ที่แสดงให้กับผู้ให้บริการ DNS ของคุณ การยืนยันมักเสร็จภายในไม่กี่นาที
- จากนั้น short_url ของโค้ดไดนามิกใหม่ทุกรายการจะใช้โดเมนนั้น โค้ดเดิมก็จะเปลี่ยนด้วย: รูปภาพของโค้ดเหล่านั้นเข้ารหัส qrflow.codes/q/... ซึ่งยังคงเปลี่ยนเส้นทางได้ จึงไม่มีสิ่งที่พิมพ์ไว้ใช้งานไม่ได้
- ตั้งชื่อโค้ดให้อ่านเข้าใจได้ด้วย slug: PATCH { "slug": "menu" } จะสร้าง go.example.com/menu ให้ทำก่อนพิมพ์
- หากใช้ Business ที่มีหลายโดเมน GET /domains จะแสดงรายการพร้อม id; ส่ง domain_id ใน POST หรือ PATCH เพื่อเลือกโดเมนสำหรับแต่ละโค้ด
ตั้งชื่อลิงก์และเลือกโดเมน
curl https://qrflow.codes/api/v1/domains -H "Authorization: Bearer $QRFLOW_KEY"
# { "default_base": "https://go.example.com", "domains": [ { "id": "…", "host": "go.example.com", "is_default": true, … }, { "id": "…", "host": "qr.example.fr", … } ] }
curl -X PATCH https://qrflow.codes/api/v1/codes/$CODE_ID -H "Authorization: Bearer $QRFLOW_KEY" -H "Content-Type: application/json" \
-d '{ "slug": "menu", "domain_id": "<id of qr.example.fr>" }'
# short_url is now https://qr.example.fr/menu
แผนภูมิการสแกนในระบบแอดมินของคุณเอง
เมื่อ: คุณต้องการดูจำนวนการสแกนต่อวัน ต่อประเทศ หรือต่ออุปกรณ์ควบคู่กับตัวเลขของคุณเอง
const stats = await qr.scans(code.id, { from: "2026-09-01", to: "2026-09-30", group: "day" });
// stats.total -> 412
// stats.rows -> [{ key: "2026-09-01", scans: 18 }, { key: "2026-09-02", scans: 25 }, ...]
// Feed rows straight into Recharts, Chart.js, or a <table>.
const byCountry = await qr.scans(code.id, { group: "country" }); // [{ key: "US", scans: 300 }, { key: "MX", scans: 41 }]
const byDevice = await qr.scans(code.id, { group: "device" }); // mobile, desktop, tablet
- หนึ่งคำขอครอบคลุมได้สูงสุด 92 วัน; หากต้องการช่วงเวลานานกว่านั้น ให้เรียกซ้ำ วันที่ใช้ UTC
- หากต้องการตัวเลขแบบเรียลไทม์โดยไม่ต้องส่งคำขอซ้ำ ให้สมัคร webhook สำหรับเหตุการณ์การสแกน: คุณจะได้รับรายละเอียดการสแกนทุกรายการเป็นชุดทุกสองสามนาที
รับ webhook ใน Next.js และตรวจสอบความถูกต้อง
เมื่อ: คุณต้องการทราบเมื่อมีการสแกนหรือเปลี่ยนโค้ดในฐานข้อมูลของคุณเองแบบเกือบเรียลไทม์
- สร้าง webhook ใน Account › Webhooks หรือด้วย POST /webhooks คัดลอก secret (whsec_...) ไปไว้ใน QRFLOW_WEBHOOK_SECRET เพียงครั้งเดียว
- อ่าน raw body เป็นข้อความก่อนแยกวิเคราะห์; ลายเซ็นครอบคลุมไบต์ที่ตรงกันทุกประการ
- ตรวจสอบความถูกต้อง แล้วเลือกการทำงานตาม event ตอบกลับ 2xx อย่างรวดเร็ว; ทำงานที่ใช้เวลานานหลังตอบกลับแล้วหรือในคิว
- กด Test บน webhook เพื่อรับ ping ที่ลงนามแล้วและยืนยันว่าตั้งค่าเชื่อมต่อถูกต้อง
import { createHmac, timingSafeEqual } from "node:crypto";
function verify(raw: string, header: string, secret: string): boolean {
const t = /t=(\d+)/.exec(header)?.[1], v1 = /v1=([a-f0-9]+)/.exec(header)?.[1];
if (!t || !v1 || Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
const expected = createHmac("sha256", secret).update(\`${t}.${raw}\`).digest("hex");
return expected.length === v1.length && timingSafeEqual(Buffer.from(expected), Buffer.from(v1));
}
export async function POST(req: Request) {
const raw = await req.text();
if (!verify(raw, req.headers.get("x-qrflow-signature") ?? "", process.env.QRFLOW_WEBHOOK_SECRET!)) {
return new Response("bad signature", { status: 401 });
}
const evt = JSON.parse(raw) as { id: string; event: string; created_at: string; data: any };
// evt.id is stable across retries: store it and skip duplicates.
switch (evt.event) {
case "scan": // evt.data.scans[]: code_id, label, slug, scanned_at, device, country, city, referrer, browser, os, language
break;
case "code.created": // evt.data.code, evt.data.source
case "code.updated": // evt.data.code, evt.data.changed[]
case "code.deleted": // evt.data.code { id, label, short_code, slug }
break;
case "ping": // the Test button
break;
}
return new Response(null, { status: 204 });
}
- ในเครื่อง ให้เปิดเซิร์ฟเวอร์ dev ผ่าน tunnel (cloudflared tunnel --url http://localhost:3000, หรือ ngrok) แล้วใช้ URL https นั้นกับ webhook ระหว่างพัฒนา
- แพ็กเกจ npm จัดการเรื่องนี้ให้คุณ:
import { parseWebhook } from "qrflow"\ตรวจสอบและแยกวิเคราะห์ได้ในครั้งเดียว (ใช้ WebCrypto จึงทำงานบน Workers และ Deno ได้ด้วย) ส่วนไคลเอนต์ Python มี verify_webhook ให้ใช้
รับ webhook ใน Python
เมื่อ: Flask, FastAPI หรือ Django รับเหตุการณ์เดียวกัน
import os, json
from flask import Flask, request, abort
from qrflow import verify_webhook # https://qrflow.codes/sdk/qrflow.py
app = Flask(__name__)
@app.post("/qrflow")
def hook():
raw = request.get_data() # bytes, before any parsing
if not verify_webhook(raw, request.headers.get("X-QRFLOW-Signature", ""), os.environ["QRFLOW_WEBHOOK_SECRET"]):
abort(401)
evt = json.loads(raw)
if evt["event"] == "scan":
for s in evt["data"]["scans"]:
print(s["code_id"], s["scanned_at"], s["country"], s["device"])
return "", 204
สร้างโค้ดหลายพันรายการจาก CSV
เมื่อ: ต้องการโค้ดหนึ่งรายการต่อ SKU ต่อที่นั่ง ต่อแท็กทรัพย์สิน หรือต่อจดหมาย
import { parse } from "csv-parse/sync";
import { readFileSync } from "node:fs";
const rows = parse(readFileSync("skus.csv"), { columns: true }) as Array<{ sku: string; url: string }>;
const out: Array<{ sku: string; id: string; short_url: string }> = [];
for (let i = 0; i < rows.length; i += 2000) { // Business: 2,000 per request
const chunk = rows.slice(i, i + 2000);
const { codes, rejected, remaining_this_month } = await qr.bulkCreate(
chunk.map((r) => ({ destination: r.url, label: r.sku })),
);
codes.forEach((c, j) => out.push({ sku: chunk[j].sku, id: c.id, short_url: c.short_url }));
if (rejected.length) console.warn(rejected); // rows that were not web addresses
console.log(remaining_this_month, "left this month");
}
- Bulk สร้างได้เฉพาะโค้ด url แบบไดนามิก โดยใช้สีเดียวกันทั้งหมด โค้ดจะส่งกลับมาตามลำดับที่คุณส่งไป โดยไม่มีแถวที่ถูกปฏิเสธ; หากไม่แน่ใจ ให้จับคู่ด้วยป้ายกำกับ
- Webhook จะได้รับเหตุการณ์ code.created หนึ่งรายการต่อคำขอ bulk โดยมี codes[] แทนที่จะได้รับหนึ่งรายการต่อโค้ด
ให้ผู้ใช้เชื่อมต่อบัญชี QRFLOW ของตนเอง (OAuth)
เมื่อ: คุณกำลังสร้างผลิตภัณฑ์สำหรับผู้อื่น และต้องการให้โค้ดอยู่ในบัญชี QRFLOW ของพวกเขา ไม่ใช่บัญชีของคุณ
- ลงทะเบียนไคลเอนต์หนึ่งครั้ง: POST https://qrflow.codes/api/oauth/register พร้อม client_name และ redirect_uris คุณจะได้รับ client_id (และ client_secret สำหรับไคลเอนต์แบบ confidential)
- ส่งผู้ใช้ไปที่ /oauth/authorize พร้อม response_type=code, client_id, redirect_uri, scope, state และ PKCE (code_challenge, code_challenge_method=S256)
- แลกเปลี่ยนโค้ดที่ /api/oauth/token บันทึก refresh token; access token มีอายุหนึ่งชั่วโมง
- เรียก /api/v1 พร้อม Authorization: Bearer <access_token> ทุกอย่างทำงานเหมือนกับการใช้คีย์ โดยอยู่ภายใต้แพ็กเกจของผู้ใช้
curl -X POST https://qrflow.codes/api/oauth/register -H "Content-Type: application/json" \
-d '{ "client_name": "Acme Menus", "redirect_uris": ["https://app.example.com/oauth/qrflow"], "token_endpoint_auth_method": "none" }'
# { "client_id": "dyn_…", "redirect_uris": [...], "grant_types": ["authorization_code","refresh_token"], … }
https://qrflow.codes/oauth/authorize?response_type=code&client_id=dyn_…&redirect_uri=https%3A%2F%2Fapp.example.com%2Foauth%2Fqrflow
&scope=profile%20codes%3Aread%20codes%3Awrite%20analytics%3Aread&state=…&code_challenge=…&code_challenge_method=S256
- Scopes มีหกรายการเหมือนกับ API keys ขอเฉพาะสิทธิ์ที่จำเป็นน้อยที่สุด; หน้าจอขอความยินยอมจะแสดงรายการเหล่านั้น
- หากแอปของคุณเป็นผู้ช่วยแชตหรือ agent ให้เพิ่ม resource=https://qrflow.codes/mcp ในคำขอ authorize แล้วเชื่อมต่อกับ MCP server แทน; token จะผูกกับเซิร์ฟเวอร์นั้น
Zapier, Make, n8n: ไม่ต้องเขียนโค้ดเลย
เมื่อ: คุณต้องการให้ข้อมูลการสแกนหรือโค้ดใหม่ไปอยู่ในชีต ช่อง Slack หรือ CRM
- สร้างทริกเกอร์ catch-hook (Zapier: Webhooks by Zapier › Catch Hook; Make: Custom webhook; n8n: Webhook node) แล้วคัดลอก URL https
- ใน Account › Webhooks ให้เพิ่ม URL นั้นและเลือก events กด Test; ping จะปรากฏในเครื่องมือและแสดงรูปแบบ payload
- แมป data.scans[] (สำหรับ scan) หรือ data.code (สำหรับ code.*) ไปยังชีต ข้อความ หรือระเบียนของคุณ
- หากต้องการสร้างโค้ดจากเครื่องมือเหล่านั้น ให้ใช้โมดูล HTTP เรียก POST /codes พร้อม Authorization header เก็บคีย์ไว้ในที่จัดเก็บข้อมูลรับรองของเครื่องมือ
- ตอนนี้ Zapier มีแอป QRFLOW.codes แล้ว: ขั้นตอน Create QR Code, Update QR Code และ Find รวมถึงทริกเกอร์ New Scan แบบทันที ไม่ต้องตั้งค่า webhook หรือ API key ดู QRFLOW with Zapier ขั้นตอนด้านล่างใช้สำหรับ Make, n8n และเครื่องมืออื่น ๆ
- เครื่องมือเหล่านี้ตรวจสอบลายเซ็นไม่ได้ URL ที่เครื่องมือให้มาคาดเดาไม่ได้ ซึ่งเป็นการป้องกันที่คุณมี; อย่าเผยแพร่ URL นี้
- หากรายการของคุณอยู่ใน Google Sheets อยู่แล้ว คุณอาจไม่จำเป็นต้องใช้ webhook: ส่วนเสริม QRFLOW for Google Sheets สร้างโค้ดให้แต่ละแถวและเขียนลิงก์สั้นกับจำนวนการสแกนกลับลงในชีตได้ เมื่อใช้ Premium โดยไม่ต้องมี API key ดู the Google Sheets add-on
การเขียนโค้ดแบบ Vibe
พรอมป์ต์สำหรับวาง
ผู้ช่วยเขียนโค้ดจะสร้างสิ่งที่ถูกต้องเมื่อได้รับแจ้งกฎตั้งแต่ต้น พรอมป์ต์เหล่านี้มีข้อกำหนดครบถ้วน วางพรอมป์ต์ เติมข้อความในวงเล็บ แล้วผู้ช่วยจะอ่านเอกสารอ้างอิง Markdown ก่อนเขียนโค้ดแม้แต่บรรทัดเดียว
เพิ่ม QR code ในแอปของฉัน
Claude, ChatGPT, Cursor, Codex, Windsurf, Copilot Chat: วางในแชต
Add QR codes to this project using the QRFLOW.codes API.
Read https://qrflow.codes/llms-full.txt before writing code; it is the complete reference.
Rules:
- The API key is in the environment variable QRFLOW_KEY. It must only be used server-side (route handler, server action, edge function). Never expose it to the browser.
- Create dynamic codes: POST https://qrflow.codes/api/v1/codes with { "type": "url", "destination_data": { "url": ... }, "label": ... }.
- Save the returned code.id and code.short_url on my record. short_url is what gets printed or displayed.
- Show the image by proxying GET /codes/:id/image.svg through my server, or by encoding short_url with a QR library on the client.
- Handle errors from the JSON body: { "error", "message" }. Map 402 to "upgrade needed", 429 to a retry with the Retry-After header.
What I want: [describe the feature, e.g. "every event in my events table gets a QR code that opens its public page; show it on the event admin page with a download button"].
สอน repo ของคุณเกี่ยวกับ QRFLOW
เพิ่มลงใน CLAUDE.md, AGENTS.md,.cursorrules หรือ.github/copilot-instructions.md
## QR codes (QRFLOW.codes)
- Docs: https://qrflow.codes/llms-full.txt (Markdown), https://qrflow.codes/api/v1/openapi.json (OpenAPI 3.1).
- Base URL https://qrflow.codes/api/v1, header Authorization: Bearer $QRFLOW_KEY. Server-side only.
- Codes are created with POST /codes { type: "url", destination_data: { url }, label }. Store code.id and code.short_url.
- Change the destination with PATCH /codes/:id { destination_data: { url } }. Never change slug/domain_id after printing.
- Image: GET /codes/:id/image.svg (needs the key). Prefer paused: true over DELETE when a print exists.
- Webhooks arrive as POST with X-QRFLOW-Signature (t=,v1=HMAC-SHA256 of "t.rawBody"); verify with the raw body.
ใน Lovable, Bolt, v0, Replit และเครื่องมือสร้างแอปอื่น ๆ
เครื่องมือสร้างแอปที่เน้น front-end ซึ่งมีแบ็กเอนด์ให้ (Supabase, serverless functions)
Integrate QRFLOW.codes QR codes. The API refuses browser calls, so create a backend function (Supabase Edge Function / serverless function) that holds the secret QRFLOW_KEY and calls POST https://qrflow.codes/api/v1/codes with { "type": "url", "destination_data": { "url": "<the page URL>" }, "label": "<name>" }. Return code.id and code.short_url to the UI and save them in the database. Render the QR in the UI by encoding short_url with a QR library; add a "Download for print" button that fetches /codes/:id/image.svg through the same backend function. Reference: https://qrflow.codes/llms-full.txt
GPT แบบกำหนดเองที่จัดการโค้ดของฉัน
ChatGPT › Create a GPT › Actions
Import from URL: https://qrflow.codes/api/v1/openapi.json
Authentication: API Key › Bearer › paste a Business key with the scopes you want the GPT to have.
Then the GPT can list, create, re-point and report on your codes. For a no-setup version, add the MCP connector instead (Developer mode › Plugins › https://qrflow.codes/mcp).
สิ่งที่ควรพูดหลังเชื่อมต่อแล้ว
Claude, ChatGPT, Claude Code ที่เชื่อมต่อกับ QRFLOW MCP server
"Make a QR code for https://example.com/fall-menu, call it Fall menu, frame caption 'Scan for menu'."
"Which of my codes got the most scans this month? Show a breakdown by country for the top one."
"Point the 'Lobby poster' code at https://example.com/events/october."
"Name the 'Business card' code's link 'hi' on my domain."
"Pause every code with 'Summer' in the label."
"Make 40 codes, one per table, going to https://example.com/order?table=1 through 40."
"Show me the PNG of the 'Front door' code."
MCP server
ใช้งานจาก Claude, ChatGPT, Cursor และ Claude Code
QRFLOW เป็น MCP server ที่ https://qrflow.codes/mcp เชื่อมต่อเพียงครั้งเดียว ลงชื่อเข้าใช้ แล้วพูดคำสั่งอย่าง "สร้าง QR code สำหรับหน้าเมนูฤดูใบไม้ร่วงของเรา ตั้งชื่อว่า menu บนโดเมนของฉัน", "เปลี่ยนปลายทางของโค้ดบนโปสเตอร์ล็อบบี้ให้ไปยังหน้าใหม่" หรือ "ใบปลิวมีการสแกนกี่ครั้งเมื่อสัปดาห์ที่แล้ว แยกตามประเทศ?" ผู้ช่วยจะได้รับเครื่องมือเดียวกับที่ API นี้มี ภายใต้กฎเดียวกัน และโค้ดจะปรากฏในแดชบอร์ดของคุณโดยมี mcp เป็นแหล่งที่มา
ไม่ใช่นักพัฒนาใช่ไหม? ดูคำอธิบายแบบภาษาทั่วไปพร้อมขั้นตอนการคลิกที่แน่นอนสำหรับผู้ช่วยแต่ละรายได้ที่ Make QR codes with your AI assistant
Glama ให้คะแนนและตรวจสอบสถานะการทำงานทุกชั่วโมงโดยอิสระ และมีรายชื่ออยู่ในไดเรกทอรี awesome-remote-mcp-servers และ MCP Registry อย่างเป็นทางการในชื่อ codes.qrflow/qrflow
เชื่อมต่อ
Customize › Connectors › Add custom connector › วางที่อยู่ หรือกด Connect ในรายการไดเรกทอรีของ QRFLOW Claude จะเปิดหน้าเข้าสู่ระบบ QRFLOW; กด Allow ใช้ได้กับทุกแพ็กเกจ
https://qrflow.codes/mcp
Settings › Security and login › เปิด Developer mode จากนั้น Settings › Plugins › + › วางที่อยู่; ลงชื่อเข้าใช้เมื่อระบบถาม ใช้ได้กับ Plus, Pro, Team, Enterprise และ Edu
https://qrflow.codes/mcp
ใช้คำสั่งเดียว จากนั้นใช้ /mcp เพื่อลงชื่อเข้าใช้ เพิ่มคีย์ Business เป็น header เพื่อข้ามขั้นตอนลงชื่อเข้าใช้
claude mcp add --transport http qrflow https://qrflow.codes/mcp
# or, with a key:
claude mcp add --transport http qrflow https://qrflow.codes/mcp --header "Authorization: Bearer $QRFLOW_KEY"
Cursor, Windsurf, VS Code และ MCP client ใดก็ได้
เพิ่ม HTTP server ที่ URL นี้ การลงชื่อเข้าใช้ OAuth จะเกิดขึ้นในเบราว์เซอร์ หรือส่ง Authorization header พร้อมคีย์
{
"mcpServers": {
"qrflow": { "type": "http", "url": "https://qrflow.codes/mcp" }
}
}
agent ของคุณเอง (Anthropic หรือ OpenAI SDK)
กำหนด MCP connector หรือ tool ให้ใช้ URL พร้อมคีย์ Business ในรูปแบบ bearer; ไม่ต้องใช้ขั้นตอนผ่านเบราว์เซอร์
// Anthropic Messages API, MCP connector
mcp_servers: [{ type: "url", url: "https://qrflow.codes/mcp", name: "qrflow", authorization_token: process.env.QRFLOW_KEY }]
ผู้ช่วยทำอะไรได้บ้าง
| Tool | ทำอะไร | Scope |
|---|---|---|
| list_code_kinds | แสดงโค้ดทุกประเภทพร้อมฟิลด์และแพ็กเกจที่ต้องใช้ ผู้ช่วยจะเรียกสิ่งนี้ก่อนสร้างโค้ดประเภทที่ไม่คุ้นเคย | profile |
| list_domains | โดเมนลิงก์ของคุณ โดเมนเริ่มต้น และ id ของแต่ละโดเมน | domains:read |
| get_qr_image | PNG ที่ผู้ช่วยแสดงหรือบันทึกได้ พร้อม URL ของ SVG สำหรับงานพิมพ์ | codes:read |
| get_account | แพ็กเกจ ฟีเจอร์ และขีดจำกัดของบัญชี | profile |
วิธีรักษาความปลอดภัย
- ผู้ช่วยจะถือ token สำหรับบัญชี ของคุณ เท่านั้น ซึ่งออกให้หลังจากที่ คุณ กด Allow บนหน้า QRFLOW คุณสามารถยกเลิกการเชื่อมต่อได้ทุกเมื่อที่ Account › Connected apps
- Token ผูกกับ MCP server; ไม่สามารถนำไปใช้ซ้ำกับ REST API ได้
- การเขียนข้อมูลทุกครั้งผ่านการตรวจสอบความถูกต้องแบบเดียวกับแดชบอร์ด: ปลายทางที่อนุญาต การตรวจสอบแพ็กเกจ และขีดจำกัดการใช้งานอย่างเหมาะสม
- เครื่องมือที่ทำลายข้อมูลจะอธิบายการทำงานอย่างระมัดระวัง:
delete_qr_codeแจ้งให้โมเดลเลือกหยุดชั่วคราวเมื่อมีงานพิมพ์แล้ว - เอกสาร Discovery อยู่ที่
/.well-known/oauth-authorization-serverและ/.well-known/oauth-protected-resource; การลงทะเบียนเป็นไปตาม RFC 7591; รองรับเฉพาะ PKCE S256
SDK และ OpenAPI spec
- TypeScript / JavaScript:
npm install qrflow(npm). ไม่มี dependencies, รองรับ ESM และ CommonJS, มี types ครบถ้วน; ใช้งานได้บน Node 18+, Bun, Deno และ Workers จัดการลองใหม่เมื่อเกิด 429 ให้คุณ และมาพร้อมverifyWebhook/parseWebhook - Python 3.9 ขึ้นไป: ใช้เฉพาะไลบรารีมาตรฐาน: qrflow.py
- OpenAPI 3.1: /api/v1/openapi.json นำเข้าไปยัง Postman หรือ Insomnia สร้าง client ในภาษาใดก็ได้ หรือแนบไปกับ ChatGPT Action
- client ทั้งสองตัวจะแสดงข้อผิดพลาดแบบมี type (
QRFlowErrorพร้อมstatus,code,message,retryAfter) และมาพร้อมตัวตรวจสอบ webhook หากต้องการนำ source TypeScript แบบไฟล์เดียวไปใช้เอง ยังคงดูได้ที่ /sdk/qrflow.ts
| TypeScript | Python | Calls |
|---|---|---|
| me() | me() | GET /me |
| catalog() | catalog() | GET /catalog |
| listCodes({ limit, q }) | list_codes(limit, q) | GET /codes |
| getCode(id) | get_code(id) | GET /codes/:id |
| createCode(input) | create_code(**fields) | POST /codes |
| updateCode(id, patch) | update_code(id, **patch) | PATCH /codes/:id |
| deleteCode(id) | delete_code(id) | DELETE /codes/:id |
| makeDynamic(id) | make_dynamic(id) | POST /codes/:id/dynamic |
| scans(id, { from, to, group }) | scans(id, from_, to, group) | GET /codes/:id/scans |
| bulkCreate(rows, colors) | bulk_create(rows, **colors) | POST /codes/bulk |
| domains() | domains() | GET /domains |
| listWebhooks() / createWebhook() / testWebhook(id) / deleteWebhook(id) | list_webhooks() / create_webhook() / test_webhook(id) / delete_webhook(id) | /webhooks |
| imageUrl(id, size) | image_url(id, size) | ที่อยู่รูปภาพ (ดึงข้อมูลโดยใช้ key) |
| verifyWebhook(raw, header, secret) | verify_webhook(raw, header, secret) | ตรวจสอบลายเซ็นสำหรับการส่งข้อมูล |
ข้อมูลอ้างอิง Endpoint
Base URL https://qrflow.codes/api/v1 เนื้อหาและการตอบกลับเป็น JSON วันที่ใช้รูปแบบ ISO 8601 ในเขตเวลา UTC เมื่อใช้ PATCH ให้ส่งเฉพาะฟิลด์ที่เปลี่ยนแปลง
GETprofile
แผน ฟีเจอร์แฟล็ก และขีดจำกัดที่ใช้กับบัญชีนี้ รวมถึง scopes ของ key
curl https://qrflow.codes/api/v1/me \
-H "Authorization: Bearer $QRFLOW_KEY"
{ "id": "…", "email": "ops@example.com", "plan": "business", "paid": true,
"features": { "dynamic_codes": true, "custom_domain": true, "link_names": true, "gs1": true, "api_keys": true },
"limits": { "saved_codes": 25000, "bulk_per_month": 10000, "bulk_per_request": 2000, "link_domains": 5, "requests_per_minute": 600 },
"auth": "api_key", "scopes": ["codes:read", "codes:write"] }
GETpublic
ประเภทดั้งเดิม (url, wifi, vcard, email, phone, sms, text, location) และประเภทย่อยราว 50 รายการ (Instagram, Google review, Wi-Fi, app store…) แต่ละรายการระบุฟิลด์ที่ต้องใช้และแผนที่จำเป็น ไม่ต้องใช้ key
curl https://qrflow.codes/api/v1/catalog
GETcodes:read
เรียงจากใหม่ไปเก่า ?limit= ได้สูงสุด 100, ?q= ใช้ค้นหาป้ายกำกับ
curl "https://qrflow.codes/api/v1/codes?limit=20&q=menu" \
-H "Authorization: Bearer $QRFLOW_KEY"
POSTcodes:write
ใช้กฎเดียวกับการบันทึกบนเว็บไซต์: โค้ด url, phone, email, sms และ location จะเป็นแบบไดนามิกในแผนแบบชำระเงิน ส่วน Wi-Fi, vCard และ text จะเก็บเนื้อหาไว้ในรูปแบบโค้ด ใส่ subtype id ใน destination_data.subtype เพื่อสร้างโค้ด เช่น Google review ระบุ domain_id ซึ่งไม่บังคับ เพื่อเลือกโดเมนลิงก์ที่ต้องการให้แสดงบนโค้ด (GET /domains ใช้แสดงรายการโดเมน)
curl -X POST https://qrflow.codes/api/v1/codes \
-H "Authorization: Bearer $QRFLOW_KEY" \
-H "Content-Type: application/json" \
-d '{ "type": "url", "destination_data": { "url": "https://example.com/menu" }, "label": "Table tents", "frame_style": "caption-below", "frame_caption": "Scan for menu" }'
{ "code": { "id": "…", "label": "Table tents", "kind": "url", "dynamic": true, "short_code": "x7k2p9a",
"short_url": "https://go.example.com/x7k2p9a", "scans": 0, "image_url": "https://qrflow.codes/api/v1/codes/…/image.svg", … } }
GETcodes:read
โค้ดพร้อมจำนวนการสแกน ลิงก์สั้น และที่อยู่รูปภาพ
curl https://qrflow.codes/api/v1/codes/$ID \
-H "Authorization: Bearer $QRFLOW_KEY"
PATCHcodes:write
เลือกแก้ไขฟิลด์ใดก็ได้ต่อไปนี้: destination_data (เฉพาะโค้ดไดนามิก โดยงานพิมพ์ยังใช้ได้), label, paused, expires_at (ISO หรือ null), slug (ชื่อของลิงก์บนโดเมนของคุณ), domain_id (โดเมนลิงก์ที่ต้องการให้แสดงบนโค้ดนี้; null = ค่าเริ่มต้นของบัญชี), fg_color, bg_color, frame_style, frame_caption, frame_caption2 ส่งเฉพาะฟิลด์ที่ต้องการเปลี่ยน
curl -X PATCH https://qrflow.codes/api/v1/codes/$ID \
-H "Authorization: Bearer $QRFLOW_KEY" \
-H "Content-Type: application/json" \
-d '{ "destination_data": { "url": "https://example.com/menu-fall" }, "slug": "menu" }'
DELETEcodes:write
ลบถาวร รวมถึงประวัติการสแกน ลิงก์ที่พิมพ์ไว้ของโค้ดไดนามิกจะหยุดทำงาน หากยังมีงานพิมพ์อยู่ ให้ใช้ paused: true แทน
curl -X DELETE https://qrflow.codes/api/v1/codes/$ID \
-H "Authorization: Bearer $QRFLOW_KEY"
204 No Content
POSTcodes:write
รูปแบบโค้ดที่พิมพ์จะเปลี่ยนไป (ตอนนี้จะเข้ารหัสลิงก์สั้น) ดังนั้นให้สร้างรูปภาพใหม่หลังจากนั้น
curl -X POST https://qrflow.codes/api/v1/codes/$ID/dynamic \
-H "Authorization: Bearer $QRFLOW_KEY"
GETcodes:read
ไฟล์ SVG พร้อมพิมพ์ที่มีกรอบและสี ?size= ใช้กำหนดความกว้างของกริดโมดูลเป็น px; ไฟล์ปรับขนาดได้โดยไม่สูญเสียคุณภาพอยู่แล้ว
curl https://qrflow.codes/api/v1/codes/$ID/image.svg \
-H "Authorization: Bearer $QRFLOW_KEY" -o code.svg
GETanalytics:read
?from= และ ?to= (วันที่ ISO สูงสุด 92 วัน ค่าเริ่มต้นคือ 30 วันล่าสุด) และ ?group= day, device, country, city, browser, os หรือ referrer ตัวเลขเดียวกับในหน้า analytics
curl "https://qrflow.codes/api/v1/codes/$ID/scans?from=2026-09-01&to=2026-09-21&group=day" \
-H "Authorization: Bearer $QRFLOW_KEY"
{ "code_id": "…", "from": "…", "to": "…", "group": "day", "total": 412,
"rows": [ { "key": "2026-09-01", "scans": 18 }, { "key": "2026-09-02", "scans": 25 }, … ] }
POSTcodes:write
สร้างโค้ด URL ได้สูงสุด 2,000 รายการต่อการเรียกหนึ่งครั้ง ทั้งหมดเป็นแบบไดนามิก นับรวมในโควตารายเดือนสำหรับการสร้างแบบกลุ่มเดียวกับหน้า Bulk (10,000 รายการใน Business) แถวที่ไม่ใช่ที่อยู่เว็บจะแสดงใน rejected ส่วนที่เหลือจะถูกสร้างขึ้น
curl -X POST https://qrflow.codes/api/v1/codes/bulk \
-H "Authorization: Bearer $QRFLOW_KEY" \
-H "Content-Type: application/json" \
-d '{ "rows": [ { "destination": "https://example.com/t/1", "label": "Table 1" }, { "destination": "https://example.com/t/2", "label": "Table 2" } ] }'
{ "codes": [ … ], "rejected": [], "remaining_this_month": 9998 }
GETcodes:read
โค้ดสำหรับบรรจุภัณฑ์ค้าปลีก แต่ละผลิตภัณฑ์ประกอบด้วย GTIN หนึ่งรายการ ที่อยู่ที่พิมพ์บนบรรจุภัณฑ์ และลิงก์ที่อยู่เบื้องหลัง ค้นหาชื่อและ GTIN ด้วย ?q= ใช้ได้ในแผน Business
curl https://qrflow.codes/api/v1/products \
-H "Authorization: Bearer $QRFLOW_KEY"
{ "products": [ { "gtin": "00860001234565", "name": "Wildflower Honey 12 oz",
"digital_link": "https://id.example.com/01/00860001234565",
"page_url": "https://id.example.com/p/00860001234565",
"links": [ { "link_type": "gs1:pip", "url": "…", "is_default": true, "batch": null } ] } ] }
POSTcodes:write
ต้องระบุ gtin และ name ส่วน brand และ url เป็นตัวเลือก ระบบจะตรวจสอบเลขตรวจสอบก่อนบันทึก และปรับรูปแบบตัวเลข 8, 12, 13 และ 14 หลักให้เป็น 14 หลัก GTIN ที่คุณมีอยู่แล้วจะส่งกลับ 409 แทนการสร้างผลิตภัณฑ์ซ้ำ
curl -X POST https://qrflow.codes/api/v1/products \
-H "Authorization: Bearer $QRFLOW_KEY" -H "Content-Type: application/json" \
-d '{"gtin":"00860001234565","name":"Wildflower Honey 12 oz","brand":"Sunny Acres","url":"https://sunnyacres.example/honey"}'
{ "product": { "gtin": "00860001234565", "digital_link": "https://id.example.com/01/00860001234565", … } }
PUTcodes:write
GTIN หนึ่งรายการสามารถนำไปยังหลายปลายทางพร้อมกัน โดยแต่ละรายการมีป้ายกำกับบอกวัตถุประสงค์ ระบบจะเลือกค่าเริ่มต้นสำหรับโทรศัพท์ ส่วนแอปที่ระบุประเภทจะได้รับปลายทางประเภทนั้น ทำงานแบบ idempotent: หากใช้ link_type และ batch เดิม ระบบจะแทนที่ลิงก์นั้นแทนการเพิ่มรายการซ้ำ จึงเรียกใช้สคริปต์ทุกคืนสองครั้งได้ ระบุ batch เพื่อกำหนดขอบเขตลิงก์ให้กับล็อตเดียว ซึ่งเป็นวิธีเผยแพร่การเรียกคืนสินค้าโดยไม่กระทบส่วนอื่นของล็อต
curl -X PUT https://qrflow.codes/api/v1/products/00860001234565/links \
-H "Authorization: Bearer $QRFLOW_KEY" -H "Content-Type: application/json" \
-d '{"link_type":"gs1:recallStatus","url":"https://sunnyacres.example/recall-a42","title":"Recall notice","batch":"A42","is_default":true}'
GETanalytics:read
จำนวนต่อ GTIN ในช่วง ?days= วันที่ผ่านมา (1 ถึง 365 ค่าเริ่มต้น 30) แยกตามประเทศ อุปกรณ์ ประเภทลิงก์ และ batch went_nowhere นับจำนวนการสแกนที่ไม่พบปลายทาง ซึ่งควรเป็นศูนย์
curl "https://qrflow.codes/api/v1/products/00860001234565/scans?days=30" \
-H "Authorization: Bearer $QRFLOW_KEY"
{ "gtin": "00860001234565", "days": 30, "total": 412, "went_nowhere": 0,
"by_link_type": [ { "key": "gs1:pip", "scans": 390 }, { "key": "gs1:recallStatus", "scans": 22 } ],
"by_batch": [ { "key": "A42", "scans": 22 } ] }
GETdomains:read
โดเมนที่เชื่อมต่อ สถานะ และโดเมนที่โค้ดไดนามิกใช้พิมพ์เป็นค่าเริ่มต้น (default_base) ส่ง id ของโดเมนเป็น domain_id ในโค้ดเพื่อให้โค้ดนั้นใช้โดเมนอื่น
curl https://qrflow.codes/api/v1/domains \
-H "Authorization: Bearer $QRFLOW_KEY"
GETwebhooks:manage
webhook ของคุณ พร้อม events สถานะล่าสุด และจำนวนครั้งที่ล้มเหลว
curl https://qrflow.codes/api/v1/webhooks \
-H "Authorization: Bearer $QRFLOW_KEY"
POSTwebhooks:manage
url ต้องเป็น https บนโฮสต์สาธารณะ; events เลือกได้จาก scan, code.created, code.updated, code.deleted ระบบจะแสดง signing secret เพียงครั้งเดียว
curl -X POST https://qrflow.codes/api/v1/webhooks \
-H "Authorization: Bearer $QRFLOW_KEY" \
-H "Content-Type: application/json" \
-d '{ "url": "https://example.com/hooks/qrflow", "events": ["scan", "code.updated"] }'
{ "webhook": { "id": "…", "url": "…", "events": ["scan", "code.updated"], "active": true, "secret": "whsec_…" } }
POSTwebhooks:manage
ส่ง ping ที่ลงลายเซ็นทันทีและรายงานการตอบกลับ
curl -X POST https://qrflow.codes/api/v1/webhooks/$WEBHOOK_ID \
-H "Authorization: Bearer $QRFLOW_KEY"
DELETEwebhooks:manage
หยุดการส่งทั้งหมด รวมถึงการลองส่งซ้ำที่อยู่ในคิว
curl -X DELETE https://qrflow.codes/api/v1/webhooks/$WEBHOOK_ID \
-H "Authorization: Bearer $QRFLOW_KEY"
204 No Content
GETpublic
id ของกรอบและสิ่งที่แต่ละกรอบต้องใช้ (caption, second line) จัดกลุ่มตามหน้า customizer ไม่ต้องใช้ key
curl https://qrflow.codes/api/v1/frames
ออบเจ็กต์ Code
ทุก endpoint ที่จัดการโค้ดจะส่งคืนข้อมูลในรูปแบบเดียวกัน ไม่ต้องสนใจฟิลด์ที่ไม่รู้จัก เพราะมีการเพิ่มฟิลด์ใหม่อยู่เรื่อย ๆ
| Field | Type | Meaning |
|---|---|---|
| id | uuid | id ที่คงที่ ใช้ในทุกการเรียกอื่น ๆ |
| label | string | null | ชื่อในแดชบอร์ด ยาวได้สูงสุด 120 ตัวอักษร ค้นหาได้ด้วย ?q= |
| kind | string | id ในแค็ตตาล็อก: url, wifi, instagram, googlereview,... kind_label คือชื่อที่อ่านเข้าใจได้ |
| type | string | รูปแบบการเข้ารหัส: url, text, wifi, vcard, email, phone, sms, location |
| destination_data | object | ฟิลด์ที่คุณส่ง (รวมถึง subtype สำหรับ kinds) destination คือสรุปข้อมูลแบบบรรทัดเดียว |
| dynamic | boolean | เป็น True เมื่อการสแกนผ่าน QRFLOW และเปลี่ยนปลายทางได้ dynamic_capable ระบุว่าประเภทนี้สามารถเป็นแบบไดนามิกในแผนแบบชำระเงินได้หรือไม่ |
| short_code | string | เจ็ดตัวอักษร ไม่มีการเปลี่ยนแปลง |
| short_url | string | สิ่งที่ต้องพิมพ์สำหรับโค้ดไดนามิก รวมโดเมนและ slug ของคุณเมื่อกำหนดไว้ |
| domain_id | uuid | null | โดเมนลิงก์ที่โค้ดนี้ใช้พิมพ์; null หมายถึงค่าเริ่มต้นของบัญชี |
| fg_color, bg_color | hex | สีของโมดูลและพื้นหลัง |
| has_logo | boolean | มีการเพิ่มโลโก้ในแดชบอร์ด; image.svg จะมีโลโก้รวมอยู่ด้วย |
| frame_style, frame_caption, frame_caption2 | string | null | id ของกรอบและคำบรรยาย ตามที่แสดงใน customizer |
| scans | integer | จำนวนการสแกนทั้งหมดตลอดอายุการใช้งาน |
| created_at, updated_at | ISO 8601 | UTC |
| manage_url | url | หน้าของโค้ดในแดชบอร์ด สำหรับลิงก์ 'Open in QRFLOW' |
| image_url | url | GET /codes/:id/image.svg ต้องใช้ Authorization header; ไม่ใช่ URL รูปภาพสาธารณะ |
| svg_download_url, png_download_url | url | SVG เดียวกัน (กรอบ สี โลโก้) และ PNG ธรรมดาผ่านลิงก์ที่ลงนาม ซึ่งใช้ได้ 24 ชั่วโมงโดยไม่ต้องมี header: สำหรับแท็ก <img> สคริปต์ และผู้ช่วยที่บันทึกไฟล์ download_expires_at ระบุเวลาหมดอายุ; การอ่านโค้ดแต่ละครั้งจะส่งลิงก์ใหม่ให้ |
รูปแบบอื่น ๆ: Scans (code_id, from, to, group, total, rows[key, scans]), Domain (id, host, status, active, is_default, verified_at, grace_until), Webhook (id, url, events, active, last_status, last_delivery_at, consecutive_failures, พร้อม secret หนึ่งครั้ง), Me (id, email, plan, paid, features, limits, auth, scopes) และ Error (error, message) เอกสาร OpenAPI ระบุ type ของทุก property
Business
Webhooks
QRFLOW เรียก URL https ของคุณเมื่อมีเหตุการณ์เกิดขึ้น สร้าง webhook ได้ที่ Account › Webhooks หรือด้วย POST /webhooks; ระบบจะแสดง signing secret ให้เพียงครั้งเดียว สร้างได้สูงสุด 10 รายการต่อบัญชี
| Event | When | data |
|---|---|---|
| scan | ส่งเป็นชุด: ทุกสองสามนาที โดยรวมการสแกนใหม่ทั้งหมดนับจากการส่งครั้งก่อน สูงสุด 500 รายการต่อการเรียก | count, from, to, scans[] พร้อม code_id, label, short_code, slug, scanned_at, device, country, city, referrer, browser, os, language |
| code.created | ทันทีจาก API และผู้ช่วย; ภายในไม่กี่นาทีจากแดชบอร์ด คำขอแบบกลุ่มจะส่ง event เดียวพร้อม bulk: true และ codes[] | code, source |
| code.updated | ใช้เวลาเช่นเดียวกัน ครอบคลุมการเปลี่ยนปลายทาง ป้ายกำกับ การหยุดชั่วคราว วันหมดอายุ ชื่อลิงก์ โดเมน สี กรอบ และการแปลงเป็นแบบไดนามิก | code, changed[] (ชื่อฟิลด์ที่เปลี่ยน) |
| code.deleted | ใช้เวลาเช่นเดียวกัน | code: { id, label, short_code, slug } |
| ping | เมื่อคุณกด Test | webhook_id, message |
ข้อมูลที่ได้รับ
ทุก payload เป็น { id, event, created_at, data } id จะคงที่ตลอดการลองส่งซ้ำของการส่งครั้งเดียว จึงใช้ค่านี้ตรวจรายการซ้ำได้
{
"id": "9b1c6d2e-…",
"event": "scan",
"created_at": "2026-09-21T18:05:00.000Z",
"data": {
"count": 2,
"from": "2026-09-21T18:00:00.000Z",
"to": "2026-09-21T18:04:12.331Z",
"scans": [
{ "code_id": "…", "label": "Table tents", "short_code": "x7k2p9a", "slug": "menu", "scanned_at": "2026-09-21T18:03:40.101Z",
"device": "mobile", "country": "US", "city": "Las Vegas", "referrer": null, "browser": "Safari", "os": "iOS", "language": "en-US" },
{ "code_id": "…", "label": "Table tents", "short_code": "x7k2p9a", "slug": "menu", "scanned_at": "2026-09-21T18:04:12.331Z",
"device": "mobile", "country": "MX", "city": "Tijuana", "referrer": null, "browser": "Chrome", "os": "Android", "language": "es-MX" }
]
}
}
{
"id": "2f0a…",
"event": "code.updated",
"created_at": "2026-09-21T18:06:00.000Z",
"data": {
"code": { "id": "…", "label": "Table tents", "kind": "url", "dynamic": true, "short_url": "https://go.example.com/menu", "scans": 412, "…": "…" },
"changed": ["destination_data"]
}
}
POST /your/endpoint HTTP/1.1
Content-Type: application/json
User-Agent: QRFLOW-Webhooks/1.0 (+https://qrflow.codes/developers)
X-QRFLOW-Event: scan
X-QRFLOW-Signature: t=1758477900,v1=5f1c…e9
ตรวจสอบลายเซ็น
X-QRFLOW-Signature: t=<unix seconds>,v1=<hex> คำนวณ HMAC-SHA256 จาก ${t}.${rawBody} โดยใช้ secret ของคุณ แล้วเปรียบเทียบกับ v1 โดยใช้การเปรียบเทียบแบบ constant time; ปฏิเสธคำขอหาก t เก่ากว่าห้านาที ใช้ไบต์ดิบที่ได้รับ ห้ามแปลงออบเจ็กต์กลับเป็นข้อความ ตัวรับข้อมูลที่ใช้งานได้สำหรับ Next.js และ Python อยู่ใน recipes และ SDK ทั้งสองมี helper นี้ให้
กฎการส่งข้อมูล
- ตอบกลับด้วย 2xx ภายใน 8 วินาที แล้วค่อยดำเนินการหลังจากตอบกลับแล้ว
- หากเป็นอย่างอื่น ระบบจะลองส่งซ้ำหลังจาก 1, 5, 15, 60, 240 และ 720 นาที
- หากล้มเหลวติดต่อกัน 20 ครั้ง ระบบจะปิด webhook และส่งอีเมลถึงเจ้าของบัญชี เปิดใช้งานอีกครั้งเมื่อแก้ไขตัวรับข้อมูลแล้ว; ระบบจะส่งรายการที่อยู่ในคิวต่อ
- URL ต้องเป็น https บนโฮสต์สาธารณะ ระบบจะปฏิเสธ localhost, ช่วง private และ qrflow.codes ใช้ tunnel ระหว่างพัฒนา
- กด Test เพื่อรับ
pingที่ลงลายเซ็น และดูสถานะที่เซิร์ฟเวอร์ของคุณตอบกลับ
ข้อผิดพลาด
ข้อผิดพลาดทุกกรณีเป็น { "error": "<code>", "message": "<what to do>" } พร้อมสถานะด้านล่าง ข้อความเขียนขึ้นเพื่อให้คนอ่านเข้าใจ; ให้แสดงข้อความนั้น
| Status | error | Meaning |
|---|
อาการ สาเหตุ วิธีแก้
การแก้ไขปัญหา
401 invalid_token ในทุกการเรียก
สาเหตุ: header ไม่ถูกต้อง หรือ key ใช้งานไม่ได้
วิธีแก้: ส่ง Authorization: Bearer qrf_live_… ให้ตรงตามนี้ทุกประการ (เว้นวรรค ไม่ใช่เครื่องหมายโคลอน) ตรวจสอบว่า key ไม่ได้ถูกเพิกถอนที่ Account › API keys หากคัดลอกจากแชตหรือเอกสาร ให้ตรวจดูว่ามีจุดต่อท้ายหรือเครื่องหมายอัญประกาศแบบโค้งหรือไม่
401 บน /api/v1 ด้วย token ที่ใช้ได้บน MCP server
สาเหตุ: token ที่ออกให้ https://qrflow.codes/mcp จะผูกกับเซิร์ฟเวอร์นั้น
วิธีแก้: ใช้ API key สำหรับ REST หรือเรียกใช้ OAuth flow อีกครั้งโดยไม่ระบุ resource= เพื่อรับ token สำหรับ REST API
402 upgrade_required เมื่อสร้าง key หรือ webhook
สาเหตุ: ทั้งสองอย่างเป็นฟีเจอร์ของ Business
วิธีแก้: อัปเกรดที่ /pricing หรือใช้ MCP server ซึ่งใช้งานได้ทุกแผนผ่านการลงชื่อเข้าใช้
402 บน POST /codes จาก OAuth app
สาเหตุ: แผนของผู้ใช้ไม่รองรับสิ่งที่แอปขอ (โค้ดไดนามิกหรือโดเมน)
วิธีแก้: อ่านฟีเจอร์จาก GET /me ก่อน แล้วปรับตามนั้น: สร้างโค้ดต่อไป (ใน Free จะเป็นแบบคงที่) หรือแจ้งผู้ใช้ว่าต้องใช้แผนใด
403 insufficient_scope
สาเหตุ: scopes จะกำหนดตายตัวเมื่อสร้าง key แก้ไข: สร้างคีย์ใหม่พร้อมขอบเขตที่ต้องการ แล้วเพิกถอนคีย์เก่า สำหรับ OAuth ให้ขอขอบเขตในคำขอ authorize
400 not_dynamic เมื่อฉัน PATCH destination_data
สาเหตุ: โค้ดเป็นแบบคงที่ เช่น Wi-Fi/vCard/ข้อความ หรือเป็นโค้ดที่สร้างด้วย Free หลังจากใช้โค้ดไดนามิกฟรีหนึ่งโค้ดไปแล้ว
แก้ไข: สำหรับ url/phone/email/sms/location ให้ POST /codes/:id/dynamic ขณะที่บัญชียังมีสิทธิ์ใช้งาน จากนั้นดาวน์โหลดและพิมพ์ใหม่ (ภาพจะเปลี่ยน) โค้ด Wi-Fi, vCard และข้อความไม่สามารถเป็นไดนามิกได้ ให้สร้างโค้ด url ที่เปิดหน้าเว็บแทน
400 no_domain เมื่อฉันตั้งค่า slug
สาเหตุ: ชื่อลิงก์จะอยู่บนโดเมนของคุณ
แก้ไข: เชื่อมต่อและยืนยันโดเมนในหน้า Account ก่อน บน qrflow.codes/q เส้นทางจะเป็น short_code เสมอ
409 conflict สำหรับ slug
สาเหตุ: โค้ดอื่นของคุณใช้ชื่อนั้นอยู่แล้ว
แก้ไข: ใช้ GET /codes?q= เพื่อค้นหา หรือเลือกชื่ออื่น ชื่อจะไม่ซ้ำกันภายในบัญชี ไม่ใช่ทั่วทั้งระบบ
เกิดข้อผิดพลาด CORS ในคอนโซลเบราว์เซอร์
สาเหตุ: API รับเฉพาะการเรียกจากเซิร์ฟเวอร์ถึงเซิร์ฟเวอร์ (และ Canva) โดยตั้งใจไว้เช่นนี้ เพราะคีย์ที่อยู่ในหน้าเว็บคือคีย์ที่รั่วไหล
แก้ไข: ย้ายการเรียกไปไว้ใน route handler, server action, edge function หรือ backend แล้วให้หน้าเว็บเรียกส่วนดังกล่าว
ภาพแสดงเครื่องหมาย QRFLOW
สาเหตุ: โค้ดนี้สร้างโดยผู้ที่ไม่ได้ลงชื่อเข้าใช้ เครื่องหมายนี้จะแสดงเฉพาะการดาวน์โหลดแบบไม่ระบุตัวตน
แก้ไข: บัญชีทุกประเภทจะนำเครื่องหมายนี้ออก รวมถึงบัญชีฟรีด้วย ภาพของโค้ดที่บันทึกไว้จะไม่มีเครื่องหมายนี้
short_url ยังคงแสดง qrflow.codes/q/… หลังจากเพิ่มโดเมนของฉัน
สาเหตุ: ยังไม่ได้ยืนยันโดเมน หรือ CNAME ตั้งค่าไม่ถูกต้อง
แก้ไข: ตรวจสอบสถานะในหน้า Account หรือใช้ GET /domains (สถานะต้องเป็น verified) โค้ดที่มีอยู่จะเปลี่ยนโดยอัตโนมัติเมื่อยืนยันแล้ว
image_url แสดง 401 ในแท็ก <img>
สาเหตุ: ต้องใช้ส่วนหัว Authorization ซึ่ง <img> ส่งให้ไม่ได้
แก้ไข: ใช้ svg_download_url หรือ png_download_url จากออบเจ็กต์ Code เดียวกัน ซึ่งเป็นลิงก์ที่ลงนามแล้วและใช้งานได้ 24 ชั่วโมงโดยไม่ต้องมีส่วนหัว หากต้องการใช้งานถาวร ให้ส่ง image_url ผ่านพร็อกซีบนเซิร์ฟเวอร์ของคุณ (ดูสูตรสำเร็จ Next.js) หรือเข้ารหัส short_url ด้วยตัวเอง
ฉันต้องการ PNG ไม่ใช่ SVG
สาเหตุ: SVG มีกรอบและโลโก้ ส่วน PNG เป็นโค้ดเปล่า
แก้ไข: GET /codes/:id/image.png (ใช้ bearer หรือ png_download_url ที่ลงนามแล้ว) จะส่งคืน PNG ขนาด 256 ถึง 2048 px หากต้องการ PNG ที่มีกรอบ ให้แปลง SVG ด้วย sharp หรือ resvg (sharp(svgBuffer).png().toBuffer())
ผู้ช่วยของฉันแจ้งว่าปลายทางรูปภาพปฏิเสธคำขอ แล้ววาดโค้ดขึ้นมาเอง
สาเหตุ: ผู้ช่วยเรียก image_url ซึ่งต้องใช้ bearer
แก้ไข: ตอนนี้ทุกโค้ดมี png_download_url และ svg_download_url และ get_qr_image จะส่งคืนลิงก์เหล่านี้ ผู้ช่วยจึงใช้ curl เรียกได้โดยไม่ต้องลงชื่อเข้าใช้ โค้ดที่วาดขึ้นในเครื่องและเข้ารหัส short_url เดียวกันยังใช้งานได้และยังนับการสแกน แต่จะไม่มีกรอบและโลโก้
Webhook ไม่มาถึงเลย
สาเหตุ: กฎของ URL หรือระบบรับข้อมูล
แก้ไข: URL ต้องเป็น https บนโฮสต์สาธารณะ (ห้ามใช้ localhost, IP ส่วนตัว หรือ qrflow.codes) กด Test บน webhook: ผลลัพธ์จะแสดงสถานะที่เซิร์ฟเวอร์ของคุณตอบกลับ เหตุการณ์สแกนจะถูกรวมเป็นชุดและอาจใช้เวลาถึงประมาณห้านาที ส่วนเหตุการณ์ code.* จากแดชบอร์ดก็จะเข้าคิวเป็นเวลาสองสามนาทีเช่นกัน ขณะที่การเขียนข้อมูลผ่าน API และ MCP จะส่งทันที
ตรวจสอบลายเซ็นไม่ผ่านเลย
สาเหตุ: คุณลงนามกับ body ที่ถูก serialize ใหม่
แก้ไข: ตรวจสอบกับไบต์ดิบที่ได้รับโดยตรง ก่อนแยกวิเคราะห์ JSON ใน Express ให้ใช้ express.raw({ type: 'application/json' }) กับ route นั้น ใน Next.js App Router ให้ใช้ await req.text() ใน Flask ให้ใช้ request.get_data() จากนั้นคำนวณ HMAC-SHA256 ของ ${t}.${raw}\
Webhook ปิดใช้งานเอง
สาเหตุ: ล้มเหลวติดต่อกัน 20 ครั้ง
แก้ไข: แก้ไขระบบรับข้อมูล แล้วเปิดใช้งานอีกครั้ง (Account › Webhooks หรือลบแล้วสร้างใหม่) เราส่งอีเมลแจ้งเมื่อเกิดเหตุการณ์นี้ การลองส่งซ้ำที่เข้าคิวจะดำเนินต่อ
Webhook ส่งซ้ำ
สาเหตุ: การตอบกลับ 2xx ที่ช้า (เกิน 8 วินาที) จะนับเป็นความล้มเหลวและมีการลองส่งซ้ำ
แก้ไข: ตอบกลับก่อน แล้วค่อยประมวลผล ใช้ id ใน payload เพื่อป้องกันการประมวลผลซ้ำ โดย id นี้จะคงเดิมในการลองส่งซ้ำ
429 rate_limited ระหว่างนำเข้าข้อมูล
สาเหตุ: 600 คำขอต่อนาทีต่อคีย์
แก้ไข: ใช้ POST /codes/bulk (2,000 โค้ดต่อคำขอ) แทนการ POST ทีละโค้ด หรือหน่วงเวลาตามจำนวนวินาทีใน Retry-After
ฉันลบโค้ดแล้วโปสเตอร์ที่พิมพ์ไว้แสดง 'Code not found'
สาเหตุ: การลบเป็นการถาวรและทำให้ลิงก์ใช้งานไม่ได้
แก้ไข: ยกเลิกไม่ได้ ครั้งต่อไปให้ใช้ PATCH { paused: true}; โค้ดที่หยุดชั่วคราวจะแสดงหน้าแจ้งข้อมูลที่เหมาะสมและกลับมาใช้งานต่อได้
คีย์ของฉันหยุดทำงานหลังจากเปลี่ยนไปใช้แพ็กเกจที่ต่ำกว่า
สาเหตุ: คีย์ยังใช้งานได้ 30 วันหลังออกจาก Business จากนั้นจะตอบกลับ 402
แก้ไข: สมัครใช้งานอีกครั้ง ไม่มีอะไรถูกลบ และคีย์เดิมจะกลับมาใช้งานได้
ไม่พบสิ่งที่ต้องการในรายการใช่ไหม ติดต่อ hello@qrflow.codes พร้อมส่งคำขอฉบับเต็มและข้อผิดพลาด JSON ที่ได้รับ บัญชี Business จะได้รับการดูแลเป็นพิเศษ
ขีดจำกัดและการใช้งานอย่างเหมาะสม
| ขีดจำกัด | |
|---|---|
| คำขอต่อนาทีต่อคีย์ | 600. หากเกินจะได้รับ 429 พร้อม Retry-After |
| คีย์ต่อบัญชี | 10 |
| Webhook ต่อบัญชี | 10 |
| โค้ดที่บันทึกไว้ (การใช้งานอย่างเหมาะสม) | Premium 1,000, Business 25,000; API จะหยุดที่สองเท่าของจำนวนนี้ |
| Bulk | Premium 500/เดือน (500 ต่อคำขอ); Business 10,000/เดือน (2,000 ต่อคำขอ) |
| โดเมนลิงก์ | Premium 1, Business 5 |
| การสแกน | ไม่จำกัด สำหรับ Premium จะส่งอีเมลแจ้งเมื่อมีการสแกน 100,000 ครั้งต่อโค้ดต่อเดือน และ Business ที่ 1,000,000 ครั้ง; ไม่มีการจำกัดความเร็ว |
| ช่วงเวลาข้อมูลวิเคราะห์การสแกน | 92 วันต่อคำขอ |
| ขนาดหน้ารายการ | 100 (?limit=) |
| Label / captions / slug | 120 / 60 / 40 อักขระ |
| หมดเวลาและการลองส่ง Webhook ซ้ำ | 8 วินาที; ลองซ้ำหลัง 1, 5, 15, 60, 240 และ 720 นาที; ปิดหลังล้มเหลวติดต่อกัน 20 ครั้ง |
| หลังออกจาก Business | คีย์และ webhook ยังใช้งานได้ 30 วัน จากนั้นจะเป็น 402 ไม่มีอะไรถูกลบ |
การใช้งานอย่างเหมาะสมคือปริมาณที่กำหนดราคาไว้ หากเกินจำนวนดังกล่าวจะไม่มีการจำกัดความเร็ว API จะหยุดที่สองเท่าของจำนวนนี้ และจะมีเจ้าหน้าที่ส่งอีเมลแจ้งก่อน หากต้องการปริมาณที่สูงขึ้น ติดต่อ hello@qrflow.codes
ความปลอดภัยสำหรับคุณและผู้ที่สแกน
QRFLOW ปกป้องบัญชีของคุณอย่างไร
- แสดงคีย์เพียงครั้งเดียวและจัดเก็บเป็นแฮช SHA-256 ไม่มีใครที่ QRFLOW อ่านคีย์กลับได้ หากทำหาย ให้สร้างคีย์ใหม่
- ทุกคำขอจะจำกัดขอบเขตไว้ที่บัญชีซึ่งเป็นเจ้าของคีย์ หากใช้ code id จากบัญชีอื่น จะได้รับ 404 และไม่มีข้อมูลรั่วไหล
- กำหนดขอบเขตของแต่ละคีย์ไว้ตายตัว ดังนั้นคีย์สำหรับแดชบอร์ดรายงานจึงสร้างหรือลบโค้ดไม่ได้
- 600 คำขอต่อนาทีต่อคีย์ หากเกินจะได้รับ 429 อย่างชัดเจน โดยไม่ทำให้บริการของทุกคนช้าลง
- ปลายทางจะใช้ได้เฉพาะรายการที่อนุญาต ได้แก่ http, https, mailto, tel, sms, geo และ app scheme บางรายการ (whatsapp, tg, signal, spotify, app stores) ระบบจะปฏิเสธ javascript:, data: และ file: ตั้งแต่ตอนสร้าง เพื่อไม่ให้การเชื่อมต่อที่ถูกเจาะระบบเปลี่ยนโค้ดของคุณให้เป็นช่องทางโจมตี
- URL ของ webhook ต้องเป็น https บนโฮสต์สาธารณะ QRFLOW จะไม่เรียกเครือข่ายส่วนตัวหรือตัวเอง การส่งทุกครั้งจะมีลายเซ็น และทุก payload มี id ที่คงที่
- ไคลเอ็นต์ OAuth ลงทะเบียนด้วย PKCE S256 และโทเค็นจะผูกกับเซิร์ฟเวอร์ที่ออกโทเค็นนั้น โทเค็นสำหรับเซิร์ฟเวอร์ MCP จึงนำไปใช้ซ้ำกับ REST API ไม่ได้
- ทุกคนสามารถเพิกถอนคีย์หรือยกเลิกการเชื่อมต่อแอปได้ในหน้า Account โดยมีผลทันที
สิ่งที่คุณควรทำ
- ใช้ตัวแปรสภาพแวดล้อม ไม่ใช่ซอร์สโค้ด หากคีย์ปรากฏในประวัติ git ให้เพิกถอนคีย์นั้น
- ใช้ฝั่งเซิร์ฟเวอร์เท่านั้น API ปฏิเสธคำขอจากเบราว์เซอร์ แต่ endpoint ของคุณเองที่ครอบ API ก็ต้องมีการยืนยันตัวตนด้วย มิฉะนั้นใครก็สร้างโค้ดโดยใช้ค่าใช้จ่ายของคุณได้
- ให้แต่ละการเชื่อมต่อมีคีย์ของตัวเองพร้อมขอบเขตที่จำเป็น และตั้งชื่อตามการเชื่อมต่อนั้น เมื่อเพิกถอนคีย์หนึ่งจึงกระทบเพียงสิ่งเดียว
- ตรวจสอบลายเซ็น webhook และปฏิเสธ timestamp ที่เก่ากว่าห้านาที
- หากข้อมูลของผู้ใช้ถูกใส่ไว้ใน labels หรือ destinations โปรดจำไว้ว่า QRFLOW จัดเก็บข้อมูลเหล่านี้ พยายามหลีกเลี่ยงการใส่ข้อมูลส่วนบุคคลใน labels
ข้อมูลที่บันทึกและไม่บันทึกจากการสแกน
- การเปลี่ยนเส้นทางแต่ละครั้งจะจัดเก็บประเภทอุปกรณ์ ประเทศ เมือง referrer เบราว์เซอร์ ระบบปฏิบัติการ และภาษา ซึ่งได้มาจากคำขอ รวมถึงแฮชทางเดียวของ code + day + IP + user agent เพื่อให้เจ้าของนับจำนวนผู้เข้าชมที่ไม่ซ้ำกันได้ ไม่สามารถแปลงแฮชกลับเป็นที่อยู่ได้
- ไม่มีการตั้งคุกกี้บนอุปกรณ์ของผู้สแกน และไม่มีการเก็บที่อยู่ IP ไว้กับข้อมูลการสแกน ระบบจะข้ามบอตที่รู้จักและโปรแกรมรวบรวมข้อมูลตัวอย่างลิงก์
- การลบโค้ดจะลบข้อมูลการสแกนของโค้ดนั้น การลบบัญชีจะลบทุกอย่าง
- ข้อความฉบับเต็ม: https://qrflow.codes/privacy และ https://qrflow.codes/terms.
การกำหนดเวอร์ชันและความเสถียร
API กำหนดเวอร์ชันไว้ใน path: /api/v1 ภายใน v1 เราจะเพิ่มฟิลด์ endpoint ชนิด และเหตุการณ์ แต่จะไม่ลบหรือเปลี่ยนชื่อสิ่งใด และโค้ดของคุณควรละเว้นฟิลด์ที่ไม่รู้จักใน response
หากจำเป็นต้องเปลี่ยนแปลง v1 ในลักษณะที่ทำให้ใช้งานร่วมกันไม่ได้ จะเผยแพร่เป็น /api/v2 และ v1 จะยังทำงานต่อไปอย่างน้อยสิบสองเดือน เจ้าของคีย์จะได้รับอีเมลแจ้งการเลิกใช้งานล่วงหน้า 90 วัน
เซิร์ฟเวอร์ MCP ใช้กฎเดียวกันกับเครื่องมือ โดยจะเพิ่มเฉพาะอาร์กิวเมนต์ และชื่อของเครื่องมือทุกตัวจะคงเดิม
เอกสาร OpenAPI ที่ /api/v1/openapi.json และ Markdown ที่ /llms-full.txt สร้างจากโค้ดที่ให้บริการ API จึงอธิบายสิ่งที่ใช้งานอยู่ในปัจจุบัน
คำถามที่นักพัฒนามักถาม
ต้องจ่ายเงินเพื่อใช้ QRFLOW API หรือไม่?
คีย์ API มาพร้อมแพ็กเกจ Business ราคา $29 ต่อเดือน ชำระรายเดือน เซิร์ฟเวอร์ MCP (Claude, ChatGPT, Cursor, Claude Code) และ OAuth สำหรับแอปของคุณเองใช้งานได้ทุกแพ็กเกจผ่านการลงชื่อเข้าใช้ และสิ่งที่สร้างได้จะเป็นไปตามแพ็กเกจนั้น GET /catalog, GET /frames และ /preview.svg ไม่ต้องใช้คีย์
สร้าง QR code ฟรีผ่าน API ได้ไหม?
ใช้คีย์ไม่ได้ หากต้องการภาพแบบคงที่ทั่วไป เครื่องมือสร้างฟรีที่ qrflow.codes หรือไลบรารี QR แบบโอเพนซอร์สก็ทำงานได้ API มีไว้สำหรับโค้ดไดนามิก โดเมนของคุณเอง ข้อมูลวิเคราะห์ การสร้างแบบกลุ่ม และ webhook ซึ่งเป็นฟีเจอร์ของบัญชีแบบชำระเงิน
เรียก API จากเบราว์เซอร์ได้ไหม?
ไม่ได้ ระบบปฏิเสธคำขอจากเบราว์เซอร์เพื่อป้องกันไม่ให้คีย์ไปอยู่ในหน้าเว็บ ให้เรียกจาก route handler, server action, edge function หรือ backend แล้วให้หน้าเว็บเรียกส่วนดังกล่าว
มีรูปแบบภาพใดบ้าง?
SVG ที่มีสี กรอบ captions และโลโก้ของคุณ (GET /codes/:id/image.svg ขนาด nominal 256 ถึง 4096 px) และ PNG แบบธรรมดา (GET /codes/:id/image.png ขนาด 256 ถึง 2048 px) ทั้งสองแบบใช้ bearer ได้ หรือใช้ svg_download_url / png_download_url ที่ลงนามแล้วซึ่งมีอยู่ในออบเจ็กต์ Code ทุกตัว ลิงก์เหล่านี้ใช้งานได้ 24 ชั่วโมงโดยไม่ต้องมีส่วนหัว เครื่องมือ MCP get_qr_image จะส่งคืน PNG แบบ inline พร้อมลิงก์ทั้งสอง
เปลี่ยน QR code หลังพิมพ์ได้ไหม?
ได้ หากเป็นโค้ดไดนามิก (url, phone, email, sms, location ในแพ็กเกจแบบชำระเงิน) ใช้ PATCH /codes/:id พร้อม destination_data ใหม่ ภาพจะไม่เปลี่ยน แต่การสแกนครั้งถัดไปจะไปยังปลายทางใหม่ โค้ด Wi-Fi, vCard และข้อความจะเก็บเนื้อหาไว้ในภาพ จึงเปลี่ยนไม่ได้
short_url ต่างจากปลายทางอย่างไร?
short_url คือลิงก์ที่อยู่ในภาพ (go.example.com/menu) ส่วนปลายทางคือที่ที่ลิงก์นั้นเปลี่ยนเส้นทางไป (https://example.com/menu-fall) คุณพิมพ์ short_url เพียงครั้งเดียว แล้วเปลี่ยนปลายทางได้บ่อยเท่าที่ต้องการ
ใช้โดเมนของตัวเองกับโค้ดได้ไหม?
ได้ Premium เชื่อมต่อได้ 1 โดเมน ส่วน Business เชื่อมต่อได้ 5 โดเมน คุณเพิ่ม CNAME และยืนยันในหน้า Account ได้ Business เลือกโดเมนสำหรับแต่ละโค้ดด้วย domain_id ส่วนชื่อของลิงก์ (slug) จะสร้าง path ที่อ่านเข้าใจง่ายบนโดเมนนั้น
ข้อมูลใดบ้างที่บันทึกเกี่ยวกับผู้สแกน?
ประเภทอุปกรณ์ ประเทศ เมือง referrer เบราว์เซอร์ ระบบปฏิบัติการ และภาษา ซึ่งได้มาจากคำขอ รวมถึงแฮชรายวันแบบทางเดียวสำหรับนับผู้เข้าชมที่ไม่ซ้ำกัน ไม่มีคุกกี้และไม่มีการจัดเก็บที่อยู่ IP มีข้อมูลเพียงพอสำหรับสร้างกราฟ แต่ไม่เพียงพอที่จะระบุตัวบุคคล รายละเอียด: https://qrflow.codes/privacy#scans
มีแพ็กเกจ npm หรือ PyPI ไหม?
npm: npm install qrflow\ (https://www.npmjs.com/package/qrflow) ไม่มี dependencies รองรับ ESM และ CommonJS มี TypeScript types ครบถ้วน ใช้งานได้กับ Node 18+, Bun, Deno และ Workers โดยครอบคลุมทุก endpoint ลองส่งคำขอ 429 ซ้ำ และมี verifyWebhook/parseWebhook ส่วน Python: ไคลเอ็นต์ไฟล์เดียวที่ https://qrflow.codes/sdk/qrflow.py (ใช้เฉพาะ standard library) พร้อม verify_webhook; จะมีแพ็กเกจ PyPI ตามมา
ใช้กับ Claude, ChatGPT, Cursor และ Claude Code ได้ไหม?
ได้ QRFLOW เป็นเซิร์ฟเวอร์ MCP ที่ https://qrflow.codes/mcp. เพิ่มเป็น connector ลงชื่อเข้าใช้ครั้งเดียว แล้วสั่งงานด้วยภาษาทั่วไปได้ เครื่องมือ 11 รายการครอบคลุมการสร้าง แก้ไข หยุดชั่วคราว ตั้งชื่อ สร้างแบบกลุ่ม วิเคราะห์ รูปภาพ และโดเมน
ให้ผู้ใช้ของฉันเชื่อมต่อบัญชี QRFLOW กับแอปของฉันเองได้ไหม?
ได้ โดยใช้ OAuth 2.0 ลงทะเบียนไคลเอนต์ที่ /api/oauth/register (ไม่ต้องมีบัญชี) ส่งผู้ใช้ไปที่ /oauth/authorize พร้อม PKCE แล้วเรียก API ด้วยโทเค็นของผู้ใช้ รหัสจะอยู่ในบัญชีของผู้ใช้ภายใต้แพ็กเกจที่ใช้อยู่
จะทดสอบเว็บฮุกบน localhost ได้อย่างไร?
เปิดให้เข้าถึงเซิร์ฟเวอร์สำหรับพัฒนาด้วย tunnel (cloudflared หรือ ngrok) แล้วใช้ที่อยู่ https ของ tunnel เป็น URL เว็บฮุก จากนั้นกด Test ที่ Account › Webhooks เพื่อรับ ping ที่ลงนามแล้ว URL เว็บฮุกต้องเป็น https สาธารณะ ระบบจะปฏิเสธ localhost และที่อยู่ส่วนตัว
จะเกิดอะไรขึ้นกับการเชื่อมต่อของฉันหากยกเลิก Business?
คีย์และเว็บฮุกจะยังใช้งานได้ 30 วัน จากนั้นจะตอบกลับด้วย 402 รหัส การสแกน และโดเมนจะยังอยู่ในบัญชี การสมัครใหม่จะเปิดใช้งานทุกอย่างอีกครั้งโดยใช้คีย์เดิม
จะสร้างรหัส Google review, Instagram, Wi-Fi หรือ PDF ผ่าน API ได้อย่างไร?
GET /catalog จะแสดงรายการทุกประเภทพร้อมฟิลด์ จากนั้น POST /codes โดยระบุ type และฟิลด์ของประเภทนั้น และเพิ่ม subtype สำหรับประเภทต่าง ๆ: { type: 'url', destination_data: { subtype: 'googlereview', placeId: 'ChIJ…' } }, { type: 'wifi', destination_data: { ssid, password, encryption: 'WPA' } }, { type: 'url', destination_data: { subtype: 'instagram', handle: 'acme' } }.
API อัปโหลดโลโก้ลงบนรหัสได้ไหม?
ยังไม่ได้ เพิ่มโลโก้ในแดชบอร์ด โดย image.svg จะมีโลโก้รวมอยู่ด้วย และ has_logo จะบอกว่ามีโลโก้หรือไม่ สี กรอบ และคำบรรยายสามารถกำหนดผ่าน API ได้ทั้งหมด
API มีความเสถียรหรือไม่?
v1 เพิ่มได้เท่านั้น ไม่มีการลบหรือเปลี่ยนชื่อ การเปลี่ยนแปลงที่ทำให้ใช้งานร่วมกันไม่ได้จะออกเป็น v2 โดยคง v1 ไว้อย่างน้อยสิบสองเดือน และแจ้งทางอีเมลล่วงหน้า 90 วัน
สำหรับเอเจนต์ เครื่องมือ และผู้ช่วยที่อ่านข้อความนี้
รูปแบบที่เครื่องอ่านได้
ทุกอย่างในหน้านี้มีรูปแบบที่ซอฟต์แวร์ดึงข้อมูลได้ ทั้งหมดสร้างจากโค้ดที่ให้บริการ API จึงเป็นข้อมูลล่าสุดเสมอ
| URL | คืออะไร | |
|---|---|---|
| llms-full.txt | https://qrflow.codes/llms-full.txt | เอกสารอ้างอิงทั้งหมดนี้ในรูปแบบ Markdown: แนวคิด ทุก endpoint ทุกเครื่องมือ MCP สูตรการใช้งาน การแก้ปัญหา และคำถามที่พบบ่อย สร้างจากแหล่งข้อมูลเดียวกับหน้านี้ |
| developers.md | https://qrflow.codes/developers.md | เอกสารเดียวกัน สำหรับเครื่องมือที่ดึงข้อมูล a.md |
| llms.txt | https://qrflow.codes/llms.txt | ดัชนีเว็บไซต์สำหรับผู้ช่วย ซึ่งชี้มายังหน้านี้ |
| API ในหน้าเดียว | https://qrflow.codes/qr-code-api | API ทำอะไร เมื่อใดควรใช้ไลบรารีฝั่งไคลเอนต์แทน และมีค่าใช้จ่ายเท่าใด สรุปเอกสารอ้างอิงฉบับนี้แบบย่อ เพื่อช่วยตัดสินใจ ไม่ใช่เพื่อเริ่มสร้าง |
| openapi.json | https://qrflow.codes/api/v1/openapi.json | OpenAPI 3.1 นำเข้าไปยัง Postman, Insomnia, เครื่องมือสร้างโค้ด หรือ ChatGPT Action ได้ |
| เซิร์ฟเวอร์ MCP | https://qrflow.codes/mcp | Streamable HTTP, OAuth พร้อมการลงทะเบียนแบบไดนามิก หรือใช้คีย์ Business เป็น bearer |
| server.json | https://qrflow.codes/.well-known/mcp/server.json | ไฟล์ manifest สำหรับรีจิสทรี MCP |
| การค้นพบ OAuth | https://qrflow.codes/.well-known/oauth-authorization-server | ข้อมูลเมตา RFC 8414; เอกสาร protected-resource อยู่ถัดจากไฟล์นี้ |
| แพ็กเกจ npm | https://www.npmjs.com/package/qrflow | npm install qrflow ไคลเอนต์ที่มี type กำกับ ไม่มี dependency และตรวจสอบเว็บฮุกได้ ไคลเอนต์ Python แบบไฟล์เดียวอยู่ที่ https://qrflow.codes/sdk/qrflow.py. |
| GitHub | https://github.com/nativecodeapps/qrflow-sdk | ไคลเอนต์ สแนปช็อต OpenAPI และตัวอย่างที่รันได้สำหรับเว็บฮุก Next.js, Workers, Express, FastAPI และ Flask ยินดีรับ Issues และ PRs |
หากมีคำถาม ไอเดีย หรือประเภทของรหัสที่เราควรเพิ่ม: hello@qrflow.codes. ข้อกำหนด: /terms. ความเป็นส่วนตัว: /privacy.