QR codes

Δημιουργήστε κωδικούς QR με λογότυπο, χρώματα, στυλ και τύπους περιεχομένου, μετά εμφανίστε ή ενημερώστε τους.

Υποστηριζόμενοι τύποι

Περάστε type ως ένα από αυτά τα κλειδιά. Τα πεδία περιεχομένου αλλάζουν με τον τύπο.

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

POST/api/v1/qr-codes

Δημιουργία QR code

Στείλτε 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, δημιουργείται ένας QR ανά γραμμή στο text.
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	Μέγεθος εικόνας σε pixel, 50–2000.
margin	integer	Όχι	0	Μονάδες ζώνης ηρεμίας, 0–25.
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	Διαφάνεια φόντου, 0–100.
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, 5–40.
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.
email_body	string	Όχι	—	Σώμα email.
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
}'

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

Παράδειγμα απάντησης

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

Όνομα	Τύπος	Απαιτείται	Περιγραφή
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 code

Όνομα	Τύπος	Απαιτείται	Περιγραφή
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 code

Όνομα	Τύπος	Απαιτείται	Προεπιλογή	Περιγραφή
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, δημιουργείται ένας QR ανά γραμμή στο text.
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	Μέγεθος εικόνας σε pixel, 50–2000.
margin	integer	Όχι	0	Μονάδες ζώνης ηρεμίας, 0–25.
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	Διαφάνεια φόντου, 0–100.
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, 5–40.
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 code

Όνομα	Τύπος	Απαιτείται	Περιγραφή
id	integer	Ναι	—

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

Τα ονόματα παραμέτρων και τα παραδείγματα JSON εμφανίζονται στα αγγλικά. Αντικαταστήστε το YOUR_API_KEY με το κλειδί του λογαριασμού σας.