امروز شنبه ۲۰ تیر ۱۴۰۵
تبلیغات
تبلیغات
تبلیغات متنی
در حال ثبت رای
این API یک سرویس ساده و سریع برای تولید QR Code بهصورت آنلاین است که بدون نیاز به نصب افزونه یا کتابخانه خاص، در تمام سایتها و پروژهها قابل استفاده میباشد. خروجی API یک تصویر PNG استاندارد با پسزمینه شفاف است و میتوان از آن در هر جایی که امکان استفاده از آدرس تصویر وجود دارد (وب، موبایل، ایمیل، PDF و چاپ) استفاده کرد.
این سرویس به صورت عمومی و مستقل در سایت ایکس وانی ارائه شده و نیازی به احراز هویت ندارد.
https://qr.x1i.ir/v1
کافی است پارامتر data را از طریق متد GET ارسال کنید.
خروجی بهصورت تصویر PNG برگردانده میشود.
https://qr.x1i.ir/v1?data=https://example.com
data (اجباری)
متنی یا لینکی که باید به QR Code تبدیل شود
نوع: string
size (اختیاری)
اندازه خروجی QR Code (به پیکسل)
نوع: number
پیشفرض: 250
بازه مجاز: 100 تا 1000
مثال:
size=150
logo (اختیاری)
URL لوگو
نوع: string
مثال:
?https://qr.x1i.ir/v1?data=https://example.com&logo=https://example.ir/img/logo.png
رنگ QR Code بهصورت HEX بدون #
نوع: string
پیشفرض: 000000 (مشکی)
مثال:
color=007aff
| https://qr.x1i.ir/v1?size=300&color=007aff&data=https://example.com |
رنگ شروع گرادینت (HEX بدون #)
نوع: string
پیشفرض: 591b84
رنگ پایان گرادینت (HEX بدون #)
نوع: string
پیشفرض: 9b35d9
مثال:
| https://qr.x1i.ir/v1?data=https://example.com&from=007aff&to=00c853 |
| https://qr.x1i.ir/v1?size=300&from=007aff&to=00c853&data=https://example.com |
فرمت: image/png
رنگ QR: مشکی
پسزمینه: شفاف
قابل کش شدن توسط مرورگر و CDN
نمونه درخواست (Raw)
GET https://qr.x1i.ir/v1?size=150&data=https://example.com
نمونه استفاده در وردپرس (صرفاً مثال)
<img
src=”https://qr.x1i.ir/v1?size=250&color=333333&data=<?php echo urlencode(get_permalink()); ?>”
alt=”QR Code”
>
HTML
<img
src=”https://qr.x1i.ir/v1?size=200&color=000000&data=https://example.com”
alt=”QR Code”
/>
استفاده در JavaScript
| const url = encodeURIComponent(window.location.href);
const img = document.createElement(‘img’); |
استفاده در PHP پروژهها
| $qr = ‘https://qr.x1i.ir/v1?size=250&data=’ . urlencode($link); |
JS / React
| src={`https://qr.x1i.ir/v1?size=200&data=${encodeURIComponent(url)}`} width={200} height={200} alt=”QR Code” /> |
استفاده عمومی مجاز است
ارسال درخواست بیش از حد ممکن است محدود شود
مسئولیت محتوای data بر عهده استفاده کننده است
Cache فعال
سایتهای وردپرسی (بدون افزونه)
قالبهای اختصاصی
فریمورکها (Laravel، React، Next و …)
اپلیکیشنهای موبایل
صفحات دانلود، معرفی، تبلیغات
لینکسازی و اشتراکگذاری
این API با تمام سیستمها و فریم ورک ها سازگار است، از جمله:
HTML و JavaScript
WordPress
Laravel و سایر فریم ورک های PHP
اپلیکیشن های موبایل
ایمیل های HTML
مقدار data باید URL Encode شود
حداکثر اندازه پیشنهادی تصویر: 500
این API برای استفاده عمومی طراحی شده است
لوگو وسط QR قرار میگیرد فرمت PNG
400 پارامتر data ارسال نشده
400 مقدار size خارج از بازه مجاز
400 فرمت رنگ نامعتبر
500 خطای داخلی سرور
