Website QR
Website QR codes are the most common type of QR code. They redirect users to a specific URL when scanned, making them perfect for linking to websites, landing pages, or any web content.
Overview
Website QR codes are simple but powerful. When scanned, they immediately open the specified URL in the user's default browser or QR code scanner app.
Creating a Website QR Code
Basic Request
curl -X POST 'https://api.v2.qrcodekit.com/api/qrs' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Account-Id: YOUR_ACCOUNT_ID' \
-H 'Content-Type: application/json' \
-d '{
"typology": "/api/qr-typologies/0598466c-025c-11ef-83ba-06c4e69992ab",
"input": {
"url": "https://example.com"
},
"title": "My Website QR"
}'Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
typology | string | Yes | The Website QR typology ID |
input.url | string | Yes | The URL to redirect to |
title | string | No | A descriptive title for the QR code |
Response
{
"@context": "/api/contexts/Qr",
"@id": "/api/qrs/974aa45a-434f-11ef-8786-b28785f18bd7",
"@type": "Qr",
"pathName": "lV58V1",
"title": "My Website QR",
"state": 2,
"typology": "/api/qr-typologies/0598466c-025c-11ef-83ba-06c4e69992ab",
"assetUrl": "https://uqrmecdn.s3.us-east-2.amazonaws.com/v2-assets/dev/lV58V1-1721119458.svg",
"input": {
"url": "https://example.com"
},
"url": "https://uqr.to/lV58V1"
}Advanced Features
Website QR codes support all advanced features available in the QRCodeKIT API:
Password Protection
Add password protection to control access to your website:
{
"typology": "/api/qr-typologies/0598466c-025c-11ef-83ba-06c4e69992ab",
"input": {
"url": "https://example.com",
"settings": {
"password_protected": true,
"password": "my-secret-password"
}
},
"title": "Protected Website QR"
}Visit Limits
Limit the number of times your QR code can be scanned:
{
"typology": "/api/qr-typologies/0598466c-025c-11ef-83ba-06c4e69992ab",
"input": {
"url": "https://example.com",
"settings": {
"access_limit": {
"max_visits": 100,
"fallback_url": "https://example.com/expired"
}
}
},
"title": "Limited Website QR"
}Learn more about Password Protection and Visit Limits in our Advanced Features guide.
Use Cases
Website QR codes are perfect for:
- Marketing Campaigns - Link to landing pages and promotional content
- Business Cards - Direct people to your company website
- Product Packaging - Link to product information or manuals
- Event Materials - Direct attendees to event details or registration
- Social Media - Share your social media profiles
- Contact Information - Link to contact forms or business information
Best Practices
URL Considerations
- Use HTTPS - Always use secure URLs for better user trust
- Keep URLs Short - Shorter URLs create smaller, more scannable QR codes
- Test Your URLs - Ensure the destination URL works correctly
- Mobile-Friendly - Make sure your website is optimized for mobile devices
QR Code Design
- High Contrast - Ensure good contrast between the QR code and background
- Adequate Size - Make QR codes large enough to scan easily
- Error Correction - Use appropriate error correction levels for your use case
- Branding - Consider adding your logo or brand colors
Analytics and Tracking
- Monitor Performance - Track scan rates and user engagement
- A/B Testing - Test different URLs or landing pages
- Geographic Data - Analyze where your QR codes are being scanned
- Device Analytics - Understand which devices are scanning your codes
Examples
Basic Website Link
{
"typology": "/api/qr-typologies/0598466c-025c-11ef-83ba-06c4e69992ab",
"input": {
"url": "https://www.qrcodekit.com"
},
"title": "QRCodeKIT Website"
}Landing Page with UTM Parameters
{
"typology": "/api/qr-typologies/0598466c-025c-11ef-83ba-06c4e69992ab",
"input": {
"url": "https://www.qrcodekit.com/features?utm_source=qr&utm_medium=print&utm_campaign=website"
},
"title": "QRCodeKIT Features"
}Password Protected Content
{
"typology": "/api/qr-typologies/0598466c-025c-11ef-83ba-06c4e69992ab",
"input": {
"url": "https://www.qrcodekit.com/premium-content",
"settings": {
"password_protected": true,
"password": "premium2024"
}
},
"title": "Premium Content Access"
}