API לקודי QR - יצירת קודי QR באופן תכנותי
שלבו יצירת קודי QR באפליקציה, בלוח SaaS, בבקאנד מובייל, בתהליך מסחר אלקטרוני או במערך אוטומציית שיווק באמצעות REST API של QR-Build. שלחו פרמטרים ב-JSON, קבלו פלט PNG, SVG או JSON ב-base64, ונהלו יעדי QR דינמיים בלי לבנות מנוע QR בעצמכם.
אתר אינטרנט
מהו API לקודי QR?
REST API הוא ממשק מבוסס HTTP שפועל לפי מוסכמות סטנדרטיות של בקשות ותשובות. ב-API לקודי QR, נקודת הקצה היא ה-URL שהאפליקציה קוראת לו, למשל POST /v1/qr, וגוף הבקשה כולל פרמטרים כמו סוג, נתונים, פורמט, גודל, צבע והאם הקוד סטטי או דינמי.
מפתחים בוחרים API כאשר יצירת QR צריכה להתרחש בתוך תהליך מוצר: משתמש SaaS לוחץ על יצירה, קטלוג מסחר אלקטרוני מייבא 5,000 SKU, אפליקציה מבקשת קוד לשיתוף, או קמפיין CRM יוצר נכסי QR מדידים אחרי טריגר.
QR-Build תומך בקודי QR סטטיים ודינמיים. קוד סטטי שומר את היעד הסופי ישירות בתמונה. קוד דינמי שומר שכבת הפניה של QR-Build, שמאפשרת עריכת יעד וניתוח סריקות אחרי הדפסה או הפצה.
איך יוצרים קוד QR עם QR-Build API?
QR-Build API מיועד לאינטגרציה בצד שרת. אם תרצו להתחיל ידנית, ראו כיצד ליצור קוד QR בממשק הוובי, ואז השתמשו ב-API כשהיצירה צריכה לרוץ מקוד.
- 1 אמתו עם מפתח ה-API שלכם. מפתח API הוא מחרוזת אישורים ייחודית שמזהה את חשבון QR-Build ומאשרת כל בקשה.
- 2 שלחו בקשת POST. פרסמו פרמטרים ב-JSON לנקודת היצירה, כולל סוג QR, נתוני יעד, פורמט תמונה וגודל.
- 3 קבלו את קוד ה-QR. התשובה יכולה להחזיר URL לתמונת PNG, סימון SVG או מטען JSON ב-base64 בהתאם לפורמט שביקשתם.
- 4 עדכנו יעדים דינמיים בעת הצורך. לקודי QR דינמיים, שלחו PATCH כדי לשנות את יעד ההפניה בלי ליצור מחדש את תמונת ה-QR המודפסת.
- 5 שלפו אנליטיקה כאשר ה-QR דינמי. השתמשו בנקודת GET לאנליטיקה כדי למשוך מספר סריקות, חותמות זמן, מיקום ופירוט מכשירים ללוח שלכם.
דוגמה לבקשת POST
curl -X POST https://api.qr-build.com/v1/qr \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type":"url","data":"https://example.com","format":"png","size":300}'דוגמה לתשובת JSON
{
"id": "qr_8x4m2p",
"type": "url",
"format": "png",
"static": true,
"imageUrl": "https://cdn.qr-build.com/qr/qr_8x4m2p.png",
"createdAt": "2026-07-01T12:00:00Z"
}אילו פורמטי בקשה ותשובה נתמכים?
בחרו פורמט תגובה לפי מקום הצגת הקוד, אופן האחסון והצורך של מערכות downstream במטא-דאטה. אנו בוחנים פורמטים לפי DPI, גודל קובץ, תמיכת דפדפנים וסבבי HTTP.
פורמטי פלט נתמכים
| פורמט | הכי מתאים ל | הערות |
|---|---|---|
| PNG | הדפסה, אימייל והטמעה מהירה | תמונת רסטר ברזולוציה קבועה; בקשו גודל גדול יותר להדפסה ואריזות. |
| SVG | אפליקציות ווב, UI ניתן להגדלה ומסכי High-DPI | פורמט וקטורי שנשאר חד בכל גודל ומתאים ללוחות רספונסיביים. |
| Base64 | HTML מוטמע, PDF ותהליכים בלי קבצים | מטמיע נתוני תמונה ב-JSON או HTML בלי URL ציבורי נפרד לתמונה. |
| JSON | עיבוד תכנותי ואחסון מטא-דאטה | מחזיר מזהים, נתוני תמונה, יעד, פורמט ומטא-דאטה של יצירה בתשובה אחת. |
סוגי QR נתמכים דרך API
נכון ל-2026, QR-Build API תומך ב-12 סוגי קודי QR. למדריך מושגי רחב יותר, ראו סקירה של סוגי קודי QR.
URL / link
Generate a QR code that opens a web page, landing page, support article, or app deep link.
WiFi
Encode network name, password, and security type so users can join a network after scanning.
vCard
Create contact QR codes with name, phone, email, company, job title, and website fields.
Point users to manuals, menus, brochures, compliance documents, or downloadable files.
Open a prefilled email with recipient, subject, and body fields.
Phone
Create scan-to-call QR codes for service desks, sales teams, and support labels.
Menu
Generate QR codes for restaurant menus, seasonal menu pages, and table placements.
Coupon
Create promotional QR codes for discounts, redemption pages, and campaign offers.
Crypto
Encode wallet addresses and payment metadata for supported cryptocurrency flows.
PayPal
Create payment QR codes that route to PayPal payment or donation destinations.
Calendar
Generate QR codes for event details, appointment reminders, and calendar invites.
Bulk
Create many QR codes from one batch request for catalogs, tickets, labels, and print runs.
קודי QR סטטיים מול דינמיים דרך API
הבחירה בין סטטי לדינמי היא החלטת ארכיטקטורה. השתמשו בסטטי ליעדים קבועים ובדינמי כאשר קמפיינים, מוצרים, תוויות או נכסים מודפסים עשויים לדרוש עריכה או אנליטיקה. למדו כיצד קודי QR סטטיים ודינמיים שונים מחוץ להקשר API.
| תכונה | QR סטטי דרך API | QR דינמי דרך API |
|---|---|---|
| יעד ניתן לעריכה | לא | כן |
| ניתוח סריקות | לא | כן |
| URL במטען ה-QR | URL יעד סופי ישיר | שכבת הפניה של QR-Build |
| הכי מתאים ל | נכסים קבועים וקישורים קבועים | קמפיינים, מוצרים, אריזות וחומרים מודפסים |
| שיטת עדכון יעד | יצירה והדפסה מחדש | PATCH לנקודת הניהול |
| התאמת תוכנית | בדיקות בחינם ושימוש קבוע | תוכניות בתשלום לאנליטיקה וניהול בנפח גבוה |
הערת מתודולוגיה: ההשוואה מבוססת על התנהגות QR-Build API. תמיד ודאו זמינות תכונות, מגבלות קצב ודרישות תוכנית מול ספק ה-QR לפני פריסה לייצור.
מקרי שימוש לאינטגרציית API לקודי QR
אלה דפוסי האינטגרציה שבהם ה-API של QR-Build שימושי יותר ממחולל ידני.
E-commerce - Per-product QR codes at scale
Generate QR codes for product pages, packaging inserts, warranty cards, receipts, and shelf labels as SKUs are created or updated. Bulk generation keeps QR output aligned with catalog data.
SaaS products - Embedded QR generation
Add QR creation to a dashboard without building a QR rendering engine, redirect layer, or analytics storage from scratch. Your product sends the request; QR-Build handles the QR output.
Marketing automation - Campaign QR codes
Trigger QR generation from CRM, CDP, email, or campaign events. Dynamic QR codes let marketers update destinations mid-campaign while keeping printed assets live.
Mobile apps - Lightweight API calls
iOS and Android apps can request QR images through a server-side backend, then render an image URL or base64 payload in the app without exposing the API key.
Document and label printing
Create QR codes for logistics labels, inventory sheets, compliance packets, and operational documents. This pattern is especially useful when labels are generated from database records.
See QR codes for inventory managementAPI מול מחולל QR ידני - מתי להשתמש בכל אחד?
מחולל קודי QR של QR-Build מתאים ליצירה ידנית. ה-API מתאים כאשר יצירת QR חייבת לרוץ מתהליך מוצר, משימת backend או צינור אוטומציה.
| תרחיש | להשתמש ב-API | להשתמש במחולל ידני |
|---|---|---|
| One-off QR code for a flyer | הכי מתאים | |
| Generate 500+ QR codes for products | הכי מתאים | |
| QR codes embedded in a SaaS dashboard | הכי מתאים | |
| Campaign QR with an updatable destination | הכי מתאים | |
| Quick WiFi QR code for an office | הכי מתאים | |
| Real-time QR generation after user action | הכי מתאים |
אימות מפתח API ואבטחה
An API key is account-scoped and should be sent as a Bearer token in the Authorization header. Do not place API keys in query strings, browser JavaScript, mobile app binaries, public repositories, or analytics logs.
Run QR generation calls from your backend, serverless function, or trusted integration service. Client-side apps should call your server, and your server should call QR-Build. This prevents users from extracting the key and consuming your quota.
Rate limiting is a server-enforced cap on requests per time window, and plan details can change as products evolve. Review the current pricing page before production rollout instead of relying on copied limits in a blog post or implementation ticket.
QR-Build enforces HTTPS for API traffic. For dynamic QR codes, the QR image stores the redirect layer, not the final destination URL; destination changes happen through authenticated management requests.
דוגמאות קוד ל-QR Code API
הערת מתודולוגיה: הדוגמאות משתמשות באותו שטח API שבו משתמש מחולל הווב של QR-Build - אין שכבת API נפרדת. החליפו מפתחות ומזהים לדוגמה בערכים מהחשבון לפני בדיקה.
יצירת קוד QR ל-URL (curl)
curl -X POST https://api.qr-build.com/v1/qr \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type":"url","data":"https://example.com","format":"png","size":300}'יצירת קוד QR ל-URL (JavaScript / Node.js)
const response = await fetch("https://api.qr-build.com/v1/qr", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.QR_BUILD_API_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
type: "url",
data: "https://example.com",
format: "svg",
size: 300
})
});
if (!response.ok) {
throw new Error(`QR generation failed: ${response.status}`);
}
const qr = await response.json();
console.log(qr.imageUrl);עדכון יעד QR דינמי
curl -X PATCH https://api.qr-build.com/v1/qr/qr_8x4m2p \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"destination":"https://example.com/new-campaign"}'איך עובדת יצירת קודי QR בכמות גדולה דרך API?
Bulk generation is designed for product catalogs, event tickets, packaging labels, inventory tags, print runs, and agency workflows where many QR codes share a common pattern but differ by destination or metadata.
A typical bulk request includes an array of rows, each with type, data, format, size, and optional label metadata. The response can return a job ID for asynchronous processing, a ZIP file URL, or a JSON array of generated QR assets depending on batch size and account settings.
For high-volume jobs, treat rate limits as part of the integration design. Queue batches, retry safely after rate-limit responses, and avoid regenerating static QR images when a cached asset is still valid.
האם אפשר לגשת לניתוחי סריקות דרך API?
Scan analytics are collected when a dynamic QR code routes through the QR-Build redirect layer. Static QR codes do not pass through a redirect layer, so they cannot provide the same scan analytics model.
Analytics API access is useful when your product needs to show QR performance inside its own dashboard, combine scan data with CRM records, or export campaign events to a warehouse. For dashboard-based reporting, see the scan analytics dashboard guide.
A webhook is an HTTP callback that can notify your server when a scan event occurs. Webhooks are useful when scan data should trigger real-time downstream actions, such as lead scoring, inventory lookup, or campaign attribution.
טעויות נפוצות באינטגרציית QR Code API
Hardcoding API keys in client-side code
We've seen teams expose keys in browser JavaScript and mobile binaries. Always make API calls from a trusted server-side environment.
Using static QR when dynamic QR is needed
If the destination may change after print, use a dynamic QR code with a redirect layer. Static QR codes require regeneration and reprinting.
Not handling API errors or rate limits
Handle non-2xx responses, retry only when safe, and display clear failure states in your product instead of silently dropping QR generation.
Generating QR images at too low a resolution
Small PNG output can look fine on screen but fail on packaging or signage. Use SVG for scalable output or request larger PNG dimensions for print.
Ignoring quiet zone requirements
The quiet zone is the blank margin around the QR code. Cropping it can make an otherwise valid QR code difficult or impossible to scan.
שיטות מומלצות לאינטגרציית QR Code API
Use dynamic QR for changeable destinations
Campaigns, product pages, support documents, and printed labels often change after distribution. Dynamic QR codes prevent costly reprints.
Cache generated static QR images
If a static QR code's payload is permanent, store the generated asset and reuse it instead of creating the same code repeatedly.
Match format to channel
Use SVG for responsive web interfaces, PNG for simple print and email workflows, and JSON or base64 when downstream systems need embedded image data.
Validate destination URLs
Validate and normalize URLs before generation so broken, unsafe, or malformed destinations do not become printed assets.
Monitor analytics after deployment
Use scan analytics to confirm that codes are being scanned, placements are working, and campaigns are routing users to the intended destination.
מילון מונחי QR Code API
אנו מגדירים את המונחים בעקביות במוצר, ב-API ובתיעוד של QR-Build כדי שמפתחים, משווקים ומנהלי מוצר יקבלו אותן החלטות יישום.
API key
An API key is a unique credential string that authenticates each request to the QR-Build API and connects usage to your account.
Endpoint
An endpoint is a specific URL your client sends requests to, such as POST /v1/qr for generation or GET /v1/qr/{id}/analytics for reporting.
Dynamic QR
A dynamic QR code is a QR code whose encoded URL points to a server-managed redirect layer, allowing the final destination to change after the QR is printed.
Redirect layer
A redirect layer is the QR-Build-managed URL encoded in a dynamic QR code; it forwards scanners to the current destination and enables analytics.
Scan analytics
Scan analytics are data collected when a dynamic QR code is scanned, including count, timestamp, device type, and geographic location.
Base64
Base64 is a binary-to-text encoding that lets QR image data travel inside JSON or HTML without a separate image file request.
Webhook
A webhook is an HTTP callback that notifies your server when a scan event or QR workflow event occurs.
שאלות נפוצות על QR Code API
תשובות לשאלות מפתחים, מוצר ואינטגרציה על שימוש ב-QR-Build API.
What is a QR code API?
A QR code API is a REST endpoint that accepts QR parameters such as type, URL, size, and format, then returns a QR code image or data object. It lets developers generate QR codes from application code instead of using a manual generator.
How do I generate a QR code with an API?
Authenticate with an API key, send a POST request with the QR parameters, and read the returned PNG, SVG, or JSON response. The simplest URL QR integration is a server-side HTTP request with a JSON body.
Is the QR-Build API free?
QR-Build offers free access for getting started with static QR generation. Dynamic QR codes, scan analytics, higher volume, and production features may require a paid plan; verify current details on the pricing page.
What output formats does the QR code API support?
The API supports PNG, SVG, base64, and JSON-style responses. Use PNG for simple print and email, SVG for scalable web or print rendering, and JSON or base64 when your application needs metadata and embedded image data.
What is the difference between static and dynamic QR codes via API?
A static QR code encodes the final destination directly into the image. A dynamic QR code encodes a redirect layer, so the destination can be edited later and scan analytics can be collected.
Can I update a dynamic QR code's destination via API?
Yes. Send a PATCH request to the QR code management endpoint with the new destination URL. The printed QR image does not need to be regenerated because the redirect layer routes future scans to the updated destination.
How do I generate bulk QR codes via API?
Use a batch request with an array of QR parameters. The API can return generated assets as a ZIP archive, a job result, or a JSON array depending on volume and account configuration.
What QR code types can I generate via the API?
As of 2026, QR-Build supports URL, WiFi, vCard, PDF, email, phone, menu, coupon, crypto, PayPal, calendar, and bulk QR workflows through API-oriented generation.
What authentication does the QR code API use?
The API uses API key authentication. Send the key as a Bearer token in the Authorization header and keep it server-side.
How do I keep my API key secure?
Store API keys in environment variables or a secret manager, make QR-Build calls from your server, never expose keys in client-side JavaScript, and rotate keys if they are committed or shared accidentally.
Can I access scan analytics via the API?
Yes. For dynamic QR codes, the analytics endpoint can return scan count, scan timestamps, device type, and location data. For dashboard-based analysis, see our QR code analytics guide.
What programming languages work with the QR code API?
Any language that can make HTTPS requests can use the API, including JavaScript, TypeScript, Python, Ruby, PHP, Go, Swift, Kotlin, Java, and C#.
What image size should I request for print use?
For print, request a large PNG or use SVG when possible. SVG is resolution-independent, while PNG should be sized high enough for the final printed dimensions and scan distance.
When should I use a QR code API instead of a manual generator?
Use the API for scale, automation, product integration, real-time generation, or campaign workflows. Use a manual generator for occasional one-off QR codes that do not need automation.
Can I use the QR code API in a mobile app?
Yes, but route calls through your server and deliver the generated image URL or data to the app. Do not embed your API key in an iOS or Android binary because it can be extracted.
משאבים קשורים של QR-Build
שלבו יצירת QR במוצר שלכם
התחילו עם מפתח API חינמי, בדקו יצירה סטטית, ואז הוסיפו ניהול QR דינמי, תהליכים בכמות גדולה וניתוחי סריקות כשהאפליקציה צריכה אותם.
מגבלות קצב ופרטי תוכנית משתנים לאורך זמן; ודאו מגבלות ייצור עדכניות לפני פריסה.
