Coduri QR

Creați coduri QR cu logo, culori, stiluri și tipuri de conținut, apoi listați-le sau actualizați-le.

Tipuri acceptate

Transmiteți type ca una dintre aceste chei. Câmpurile de conținut se schimbă odată cu tipul.

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

POST/api/v1/qr-codes

Creează cod QR

Trimiteți JSON în corpul cererii. name și type sunt obligatorii. Pentru tipurile url, transmiteți url. Adăugați style, culori și qr_code_logo pentru a replica un cod din studio. Tipul file nu este disponibil pe API.

Nume	Tip	Obligatoriu	Implicit	Descriere
name	string	Da	—	Eticheta salvată pe resursă.
type	string	Da	url	Tip de conținut. Una dintre cheile QR acceptate, exceptând file.
url	string	Nu	—	URL destinație. Obligatoriu când type este url.
text	string	Nu	—	Text simplu. Obligatoriu când type este text. Pentru text în masă, separați liniile în acest câmp.
url_dynamic	boolean	Nu	false	Dacă este true, se creează un link scurt, iar QR-ul îl encodează, astfel destinația poate fi schimbată ulterior.
project_id	integer	Nu	—	Proiectul la care se atașează resursa.
is_bulk	boolean	Nu	false	Dacă este true și type este text, se creează un QR pentru fiecare linie din text.
style	string	Nu	square	Forma modulului. Exemple: square, dot, rounded, heart, hexagon.
inner_eye_style	string	Nu	square	Forma modelului de căutare interior. Exemple: square, dot, circle, rounded.
outer_eye_style	string	Nu	square	Forma modelului de căutare exterior. Exemple: square, circle, rounded, flower.
size	integer	Nu	500	Dimensiunea imaginii în pixeli, 50–2000.
margin	integer	Nu	0	Module zonă de liniște, 0–25.
ecc	string	Nu	M	Corecție de erori: L, M, Q sau H. Folosiți H când adăugați un logo.
foreground_type	string	Nu	color	color sau gradient.
foreground_color	string	Nu	#000000	Culoarea modulelor ca HEX.
foreground_gradient_style	string	Nu	horizontal	vertical, horizontal, diagonal, inverse_diagonal sau radial.
foreground_gradient_one	string	Nu	—	Prima culoare HEX a gradientului.
foreground_gradient_two	string	Nu	—	A doua culoare HEX a gradientului.
background_color	string	Nu	#ffffff	Culoarea HEX de fundal. Păstrați-o mai deschisă decât modulele.
background_color_transparency	integer	Nu	0	Transparența fundalului, 0–100.
custom_eyes_color	boolean	Nu	false	Dacă este true, ochii folosesc eyes_inner_color și eyes_outer_color.
eyes_inner_color	string	Nu	#000000	Culoarea HEX a ochiului interior.
eyes_outer_color	string	Nu	#000000	Culoarea HEX a ochiului exterior.
qr_code_logo	string	Nu	—	URL-ul imaginii logo-ului sau cheia fișierului încărcat.
qr_code_logo_size	number	Nu	25	Dimensiunea logo-ului ca procent din QR, 5–40.
frame	string	Nu	—	Cheie de ramă opțională din studio.
frame_text	string	Nu	—	Legendă desenată pe ramă.

Câmpuri de conținut după tip

Nume	Tip	Obligatoriu	Implicit	Descriere
phone	string	Nu	—	Număr de telefon când type este phone.
sms	string	Nu	—	Număr de telefon când type este sms.
sms_body	string	Nu	—	Corpul mesajului SMS.
email	string	Nu	—	Destinatar când type este email.
email_subject	string	Nu	—	Subiectul e-mailului.
email_body	string	Nu	—	Corpul e-mailului.
whatsapp	string	Nu	—	Număr WhatsApp, doar cifre.
whatsapp_body	string	Nu	—	Text WhatsApp precompletat.
wifi_ssid	string	Nu	—	Numele rețelei când type este wifi.
wifi_password	string	Nu	—	Parola Wi-Fi.
wifi_encryption	string	Nu	WPA	nopass, WEP, WPA sau WPA/WPA2.
location_latitude	number	Nu	—	Latitudine când type este location.
location_longitude	number	Nu	—	Longitudine când type este location.
event	string	Nu	—	Titlul evenimentului când type este event.
event_start_datetime	string	Nu	—	Dată-oră ISO pentru începutul evenimentului.
vcard first_name / last_name / email	string	Nu	—	Câmpuri vCard: first_name, last_name, email și celelalte chei din studio.

Exemplu de cerere

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
}'

Mai multe exemple

QR cu gradient

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
}'

QR Wi-Fi

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"
}'

Exemplu de răspuns

{
  "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

Listează cod QR

Nume	Tip	Obligatoriu	Descriere
page	integer	Nu	Page number (default 1)
results_per_page	integer	Nu	Items per page (default 25, max 100)
search	string	Nu	Search term
search_by	string	Nu	Column to search
order_by	string	Nu	Sort column
order_type	string	Nu	asc or desc
datetime_start	string	Nu	ISO datetime filter start
datetime_end	string	Nu	ISO datetime filter end
project_id	integer	Nu	—
type	string	Nu	—

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

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

Citește un cod QR

Nume	Tip	Obligatoriu	Descriere
id	integer	Da	—

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

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

Actualizează cod QR

Nume	Tip	Obligatoriu	Implicit	Descriere
id	integer	Da	—	—
name	string	Nu	—	Eticheta salvată pe resursă.
type	string	Nu	url	Tip de conținut. Una dintre cheile QR acceptate, exceptând file.
url	string	Nu	—	URL destinație. Obligatoriu când type este url.
text	string	Nu	—	Text simplu. Obligatoriu când type este text. Pentru text în masă, separați liniile în acest câmp.
url_dynamic	boolean	Nu	false	Dacă este true, se creează un link scurt, iar QR-ul îl encodează, astfel destinația poate fi schimbată ulterior.
project_id	integer	Nu	—	Proiectul la care se atașează resursa.
is_bulk	boolean	Nu	false	Dacă este true și type este text, se creează un QR pentru fiecare linie din text.
style	string	Nu	square	Forma modulului. Exemple: square, dot, rounded, heart, hexagon.
inner_eye_style	string	Nu	square	Forma modelului de căutare interior. Exemple: square, dot, circle, rounded.
outer_eye_style	string	Nu	square	Forma modelului de căutare exterior. Exemple: square, circle, rounded, flower.
size	integer	Nu	500	Dimensiunea imaginii în pixeli, 50–2000.
margin	integer	Nu	0	Module zonă de liniște, 0–25.
ecc	string	Nu	M	Corecție de erori: L, M, Q sau H. Folosiți H când adăugați un logo.
foreground_type	string	Nu	color	color sau gradient.
foreground_color	string	Nu	#000000	Culoarea modulelor ca HEX.
foreground_gradient_style	string	Nu	horizontal	vertical, horizontal, diagonal, inverse_diagonal sau radial.
foreground_gradient_one	string	Nu	—	Prima culoare HEX a gradientului.
foreground_gradient_two	string	Nu	—	A doua culoare HEX a gradientului.
background_color	string	Nu	#ffffff	Culoarea HEX de fundal. Păstrați-o mai deschisă decât modulele.
background_color_transparency	integer	Nu	0	Transparența fundalului, 0–100.
custom_eyes_color	boolean	Nu	false	Dacă este true, ochii folosesc eyes_inner_color și eyes_outer_color.
eyes_inner_color	string	Nu	#000000	Culoarea HEX a ochiului interior.
eyes_outer_color	string	Nu	#000000	Culoarea HEX a ochiului exterior.
qr_code_logo	string	Nu	—	URL-ul imaginii logo-ului sau cheia fișierului încărcat.
qr_code_logo_size	number	Nu	25	Dimensiunea logo-ului ca procent din QR, 5–40.
frame	string	Nu	—	Cheie de ramă opțională din studio.
frame_text	string	Nu	—	Legendă desenată pe ramă.

Exemplu de cerere

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}

Șterge cod QR

Nume	Tip	Obligatoriu	Descriere
id	integer	Da	—

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

Numele parametrilor și exemplele JSON sunt în engleză. Înlocuiți YOUR_API_KEY cu cheia contului.