مستندات و تستکننده API ساخت QR کد
با استفاده از آدرس https://qrcodsaaz.ir/api/generate.php میتوانید بارکدهای QR سفارشی تولید کنید. کلید رایگان پیشفرض است یا کلید اختصاصی خود را وارد کنید تا خروجی را به صورت زنده مشاهده کنید.
راهنمای سریع اتصال به API
۱. آدرس و متد درخواست
تمامی درخواستها باید به آدرس زیر با متد POST ارسال شوند:
۲. هدرهای الزامی (Headers)
Content-Type: application/json: برای ارسال دادهها به فرمت JSON.X-API-Key: YOUR_KEY_HERE: کلید اختصاصی شما (برای مشتریان پرمیوم) یا کلید رایگان عمومی.
۳. ساختار بدنه درخواست (Body Parameters)
بدنه درخواست باید یک آبجکت JSON شامل فیلدهای زیر باشد:
۴. نمونه کد اتصال (PHP cURL)
طرحهای اشتراک پرمیوم
- تا ۵,۰۰۰ درخواست در روز
- بدون واترمارک در خروجی
- پشتیبانی از تمامی فرمتها
- دسترسی به پنل اختصاصی مشتریان
- مناسب برای سایتهای متوسط
- تا ۲۰,۰۰۰ درخواست در روز
- بدون واترمارک + اولویت در پردازش
- قابلیت محدودسازی دامنه (CORS)
- دسترسی به پنل اختصاصی مشتریان
- مناسب برای اپلیکیشنها و فروشگاهها
- درخواست نامحدود (Unlimited)
- بدون واترمارک + اولویت در پردازش
- پشتیبانی وبهوک (Webhooks)
- دسترسی به پنل اختصاصی مشتریان
- مناسب برای سازمانها و استارتاپها
انواع دادهها
متن ساده (Plain Text)
هر متنی را مستقیماً داخل بارکد قرار میدهد. پس از اسکن شده، متن دقیقاً همان چیزی است که تایپ کردهاید.
لینک وبسایت (URL)
با اسکن بارکد، کاربر مستقیماً به آدرس اینترنتی مورد نظر شما هدایت میشود. آدرسها به صورت خودکار اعتبارسنجی میشوند.
ارسال ایمیل (Email)
فرمت استاندارد MATMSG را تولید میکند. پس از اسکن، اپلیکیشن ایمیل کاربر باز شده و آدرس، موضوع و متن ایمیل از پیش پر میشود.
اتصال به وایفای (WiFi)
کاربر بدون نیاز به تایپ رمز عبور، تنها با اسکن بارکد به شبکه وایفای شما متصل میشود (پشتیبانی از WPA/WEP).
کارت ویزیت الکترونیکی (vCard)
اطلاعات تماس شامل نام، شماره موبایل و ایمیل را در فرمت vCard 3.0 ذخیره میکند که مستقیماً در دفترچه تلفن کاربر ذخیره میشود.
شماره تماس تلفنی (Telephone)
با اسکن این بارکد، شماره تلفن شما در دیالر (Dialer) گوشی کاربر شمارهگیری میشود. کد کشور به صورت جداگانه دریافت میگردد.
سوالات متداول
آیا استفاده از این API کاملاً رایگان است؟
qrcodsaaz_FREE_KEY_2025) برای همگان رایگان است. اما خروجیهای رایگان دارای واترمارک کوچک هستند و محدودیتهای حجمی بر روی آیپیهای عمومی اعمال میشود. برای استفاده بدون محدودیت و بدون واترمارک، میتوانید یکی از طرحهای پرمیوم را انتخاب کنید.
تفاوت کلید رایگان و کلید پرمیوم در تستکننده این صفحه چیست؟
https://qrcodsaaz.ir/ در پایین آن درج میشود. اگر کلید پرمیوم خود را در کادر بالا وارد کنید، خروجی کاملاً تمیز و بدون واترمارک تولید خواهد شد.
فرمت خروجی چیست و آیا PNG هم پشتیبانی میشود؟
SVG (برداری و بدون افت کیفیت) است. این فایل به دو شکل svg_code (کدهای خام تگهای SVG) و image_base64 (کد شده برای قرار دادن مستقیم در تگ img) در جیسون برگردانده میشود. در همین صفحه ابزاری قرار دارد که با استفاده از Canvas مرورگر، خروجی SVG را به صورت خودکار به PNG با کیفیت بالا برای شما تبدیل و دانلود میکند.