QR কোড

লোগো, রং, স্টাইল ও কনটেন্ট ধরনসহ QR কোড তৈরি করুন, তারপর তালিকা করুন বা আপডেট করুন।

সমর্থিত ধরন

type হিসেবে এই কীগুলোর একটি পাঠান। কনটেন্ট ফিল্ড ধরন অনুযায়ী বদলায়।

text
url
phone
sms
email
whatsapp
facetime
location
wifi
event
vcard
crypto
paypal
upi
epc
pix

POST/api/v1/qr-codes

QR কোড তৈরি

অনুরোধ বডিতে JSON পাঠান। name ও type আবশ্যক। url ধরনের জন্য url দিন। স্টুডিওর ডিজাইন মেলাতে style, রং এবং qr_code_logo যোগ করুন। file ধরন API-তে নেই।

নাম	ধরন	প্রয়োজন	ডিফল্ট	বিবরণ
name	string	হ্যাঁ	—	রিসোর্সে সংরক্ষিত লেবেল।
type	string	হ্যাঁ	url	কনটেন্টের ধরন। সমর্থিত QR কীগুলোর একটি, file ছাড়া।
url	string	না	—	গন্তব্য URL। type যখন url হয় তখন আবশ্যক।
text	string	না	—	সাধারণ টেক্সট। type যখন text হয় তখন আবশ্যক। বাল্ক টেক্সটের জন্য এই ফিল্ডে লাইন আলাদা করুন।
url_dynamic	boolean	না	false	true হলে একটি শর্ট লিংক তৈরি হয় এবং QR সেই লিংক এনকোড করে, যাতে পরে গন্তব্য বদলানো যায়।
project_id	integer	না	—	রিসোর্স সংযুক্ত করার প্রকল্প।
is_bulk	boolean	না	false	true এবং type যদি text হয়, text-এর প্রতি লাইনে একটি QR তৈরি হয়।
style	string	না	square	মডিউলের আকৃতি। উদাহরণ: square, dot, rounded, heart, hexagon।
inner_eye_style	string	না	square	ভিতরের ফাইন্ডার-প্যাটার্ন আকৃতি। উদাহরণ: square, dot, circle, rounded।
outer_eye_style	string	না	square	বাইরের ফাইন্ডার-প্যাটার্ন আকৃতি। উদাহরণ: square, circle, rounded, flower।
size	integer	না	500	পিক্সেলে ছবির আকার, ৫০–২০০০।
margin	integer	না	0	কুয়েট-জোন মডিউল, ০–২৫।
ecc	string	না	M	ত্রুটি সংশোধন: L, M, Q বা H। লোগো যোগ করলে H ব্যবহার করুন।
foreground_type	string	না	color	color বা gradient।
foreground_color	string	না	#000000	মডিউলের রং HEX হিসেবে।
foreground_gradient_style	string	না	horizontal	vertical, horizontal, diagonal, inverse_diagonal বা radial।
foreground_gradient_one	string	না	—	প্রথম গ্রেডিয়েন্ট HEX রং।
foreground_gradient_two	string	না	—	দ্বিতীয় গ্রেডিয়েন্ট HEX রং।
background_color	string	না	#ffffff	পটভূমির HEX রং। মডিউলের চেয়ে হালকা রাখুন।
background_color_transparency	integer	না	0	পটভূমির স্বচ্ছতা, ০–১০০।
custom_eyes_color	boolean	না	false	true হলে আইগুলো eyes_inner_color ও eyes_outer_color ব্যবহার করে।
eyes_inner_color	string	না	#000000	ভিতরের আইয়ের HEX রং।
eyes_outer_color	string	না	#000000	বাইরের আইয়ের HEX রং।
qr_code_logo	string	না	—	লোগো ছবির URL বা আপলোড করা ফাইল কী।
qr_code_logo_size	number	না	25	QR-এর শতাংশ হিসেবে লোগোর আকার, ৫–৪০।
frame	string	না	—	স্টুডিও থেকে ঐচ্ছিক ফ্রেম কী।
frame_text	string	না	—	ফ্রেমে আঁকা ক্যাপশন।

ধরন অনুযায়ী কনটেন্ট ফিল্ড

নাম	ধরন	প্রয়োজন	ডিফল্ট	বিবরণ
phone	string	না	—	type যখন phone হয় তখন ফোন নম্বর।
sms	string	না	—	type যখন sms হয় তখন ফোন নম্বর।
sms_body	string	না	—	SMS বার্তার মূল অংশ।
email	string	না	—	type যখন email হয় তখন প্রাপক।
email_subject	string	না	—	ইমেইল বিষয়।
email_body	string	না	—	ইমেইল মূল অংশ।
whatsapp	string	না	—	WhatsApp নম্বর, শুধু সংখ্যা।
whatsapp_body	string	না	—	WhatsApp পূর্বভরা টেক্সট।
wifi_ssid	string	না	—	type যখন wifi হয় তখন নেটওয়ার্কের নাম।
wifi_password	string	না	—	Wi-Fi পাসওয়ার্ড।
wifi_encryption	string	না	WPA	nopass, WEP, WPA বা WPA/WPA2।
location_latitude	number	না	—	type যখন location হয় তখন অক্ষাংশ।
location_longitude	number	না	—	type যখন location হয় তখন দ্রাঘিমাংশ।
event	string	না	—	type যখন event হয় তখন ইভেন্টের শিরোনাম।
event_start_datetime	string	না	—	ইভেন্ট শুরুর ISO তারিখ-সময়।
vcard first_name / last_name / email	string	না	—	vCard ফিল্ড: first_name, last_name, email এবং অন্যান্য স্টুডিও কী।

অনুরোধের উদাহরণ

curl -X POST 'https://forqrcode.com/api/v1/qr-codes' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Website QR",
  "type": "url",
  "url": "https://forqrcode.com",
  "style": "rounded",
  "size": 500,
  "ecc": "M",
  "foreground_color": "#17191c",
  "background_color": "#ffffff",
  "qr_code_logo": "https://forqrcode.com/logo.png",
  "qr_code_logo_size": 25
}'

আরও উদাহরণ

গ্রেডিয়েন্ট QR

curl -X POST 'https://forqrcode.com/api/v1/qr-codes' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Gradient QR",
  "type": "url",
  "url": "https://forqrcode.com",
  "style": "dot",
  "inner_eye_style": "circle",
  "outer_eye_style": "rounded",
  "foreground_type": "gradient",
  "foreground_gradient_style": "radial",
  "foreground_gradient_one": "#5c8b29",
  "foreground_gradient_two": "#25492f",
  "background_color": "#ffffff",
  "size": 600
}'

Wi-Fi QR

curl -X POST 'https://forqrcode.com/api/v1/qr-codes' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Office Wi-Fi",
  "type": "wifi",
  "wifi_ssid": "Guest",
  "wifi_password": "correct-horse",
  "wifi_encryption": "WPA",
  "style": "square",
  "ecc": "H"
}'

প্রতিক্রিয়ার উদাহরণ

{
  "data": {
    "id": 1,
    "type": "url",
    "name": "Website QR",
    "qr_code": "https://…/qr-codes/…/qr.svg",
    "settings": {
      "style": "rounded",
      "size": 500,
      "ecc": "M"
    }
  }
}

GET/api/v1/qr-codes

QR কোড তালিকা

নাম	ধরন	প্রয়োজন	বিবরণ
page	integer	না	Page number (default 1)
results_per_page	integer	না	Items per page (default 25, max 100)
search	string	না	Search term
search_by	string	না	Column to search
order_by	string	না	Sort column
order_type	string	না	asc or desc
datetime_start	string	না	ISO datetime filter start
datetime_end	string	না	ISO datetime filter end
project_id	integer	না	—
type	string	না	—

curl -X GET 'https://forqrcode.com/api/v1/qr-codes' \
  -H 'Authorization: Bearer YOUR_API_KEY'

GET/api/v1/qr-codes/{id}

একটি QR কোড পড়ুন

নাম	ধরন	প্রয়োজন	বিবরণ
id	integer	হ্যাঁ	—

curl -X GET 'https://forqrcode.com/api/v1/qr-codes/{id}' \
  -H 'Authorization: Bearer YOUR_API_KEY'

PATCH/api/v1/qr-codes/{id}

QR কোড আপডেট

নাম	ধরন	প্রয়োজন	ডিফল্ট	বিবরণ
id	integer	হ্যাঁ	—	—
name	string	না	—	রিসোর্সে সংরক্ষিত লেবেল।
type	string	না	url	কনটেন্টের ধরন। সমর্থিত QR কীগুলোর একটি, file ছাড়া।
url	string	না	—	গন্তব্য URL। type যখন url হয় তখন আবশ্যক।
text	string	না	—	সাধারণ টেক্সট। type যখন text হয় তখন আবশ্যক। বাল্ক টেক্সটের জন্য এই ফিল্ডে লাইন আলাদা করুন।
url_dynamic	boolean	না	false	true হলে একটি শর্ট লিংক তৈরি হয় এবং QR সেই লিংক এনকোড করে, যাতে পরে গন্তব্য বদলানো যায়।
project_id	integer	না	—	রিসোর্স সংযুক্ত করার প্রকল্প।
is_bulk	boolean	না	false	true এবং type যদি text হয়, text-এর প্রতি লাইনে একটি QR তৈরি হয়।
style	string	না	square	মডিউলের আকৃতি। উদাহরণ: square, dot, rounded, heart, hexagon।
inner_eye_style	string	না	square	ভিতরের ফাইন্ডার-প্যাটার্ন আকৃতি। উদাহরণ: square, dot, circle, rounded।
outer_eye_style	string	না	square	বাইরের ফাইন্ডার-প্যাটার্ন আকৃতি। উদাহরণ: square, circle, rounded, flower।
size	integer	না	500	পিক্সেলে ছবির আকার, ৫০–২০০০।
margin	integer	না	0	কুয়েট-জোন মডিউল, ০–২৫।
ecc	string	না	M	ত্রুটি সংশোধন: L, M, Q বা H। লোগো যোগ করলে H ব্যবহার করুন।
foreground_type	string	না	color	color বা gradient।
foreground_color	string	না	#000000	মডিউলের রং HEX হিসেবে।
foreground_gradient_style	string	না	horizontal	vertical, horizontal, diagonal, inverse_diagonal বা radial।
foreground_gradient_one	string	না	—	প্রথম গ্রেডিয়েন্ট HEX রং।
foreground_gradient_two	string	না	—	দ্বিতীয় গ্রেডিয়েন্ট HEX রং।
background_color	string	না	#ffffff	পটভূমির HEX রং। মডিউলের চেয়ে হালকা রাখুন।
background_color_transparency	integer	না	0	পটভূমির স্বচ্ছতা, ০–১০০।
custom_eyes_color	boolean	না	false	true হলে আইগুলো eyes_inner_color ও eyes_outer_color ব্যবহার করে।
eyes_inner_color	string	না	#000000	ভিতরের আইয়ের HEX রং।
eyes_outer_color	string	না	#000000	বাইরের আইয়ের HEX রং।
qr_code_logo	string	না	—	লোগো ছবির URL বা আপলোড করা ফাইল কী।
qr_code_logo_size	number	না	25	QR-এর শতাংশ হিসেবে লোগোর আকার, ৫–৪০।
frame	string	না	—	স্টুডিও থেকে ঐচ্ছিক ফ্রেম কী।
frame_text	string	না	—	ফ্রেমে আঁকা ক্যাপশন।

অনুরোধের উদাহরণ

curl -X PATCH 'https://forqrcode.com/api/v1/qr-codes/{id}' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "url": "https://forqrcode.com/pricing",
  "foreground_color": "#5d2a1a"
}'

DELETE/api/v1/qr-codes/{id}

QR কোড মুছুন

নাম	ধরন	প্রয়োজন	বিবরণ
id	integer	হ্যাঁ	—

curl -X DELETE 'https://forqrcode.com/api/v1/qr-codes/{id}' \
  -H 'Authorization: Bearer YOUR_API_KEY'

প্যারামিটার নাম ও JSON উদাহরণ ইংরেজিতে। YOUR_API_KEY আপনার কী দিয়ে প্রতিস্থাপন করুন।