QR kodları

Logo, renkler, stiller ve içerik türleriyle QR kodları oluşturun, ardından listeleyin veya güncelleyin.

Desteklenen türler

type olarak bu anahtarlardan birini geçin. İçerik alanları türe göre değişir.

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

POST/api/v1/qr-codes

QR kodu oluştur

İstek gövdesinde JSON gönderin. name ve type zorunludur. url türleri için url verin. Stüdyodaki tasarıma uydurmak için style, renkler ve qr_code_logo ekleyin. file türü API’de yok.

Ad	Tür	Gerekli	Varsayılan	Açıklama
name	string	Evet	—	Kaynakta saklanan etiket.
type	string	Evet	url	İçerik türü. Desteklenen QR anahtarlarından biri, file hariç.
url	string	Hayır	—	Hedef URL. type url olduğunda zorunlu.
text	string	Hayır	—	Düz metin. type text olduğunda zorunlu. Toplu metinde satırları bu alanda ayırın.
url_dynamic	boolean	Hayır	false	true ise kısa bağlantı oluşturulur ve QR o bağlantıyı kodlar; hedef sonradan değiştirilebilir.
project_id	integer	Hayır	—	Kaynağın ekleneceği proje.
is_bulk	boolean	Hayır	false	true ve type text ise text içindeki her satır için bir QR oluşturulur.
style	string	Hayır	square	Modül şekli. Örnekler: square, dot, rounded, heart, hexagon.
inner_eye_style	string	Hayır	square	İç bulucu deseni şekli. Örnekler: square, dot, circle, rounded.
outer_eye_style	string	Hayır	square	Dış bulucu deseni şekli. Örnekler: square, circle, rounded, flower.
size	integer	Hayır	500	Piksel cinsinden görüntü boyutu, 50–2000.
margin	integer	Hayır	0	Sessiz bölge modülleri, 0–25.
ecc	string	Hayır	M	Hata düzeltme: L, M, Q veya H. Logo eklerken H kullanın.
foreground_type	string	Hayır	color	color veya gradient.
foreground_color	string	Hayır	#000000	HEX olarak modül rengi.
foreground_gradient_style	string	Hayır	horizontal	vertical, horizontal, diagonal, inverse_diagonal veya radial.
foreground_gradient_one	string	Hayır	—	İlk gradyan HEX rengi.
foreground_gradient_two	string	Hayır	—	İkinci gradyan HEX rengi.
background_color	string	Hayır	#ffffff	Arka plan HEX rengi. Modüllerden daha açık tutun.
background_color_transparency	integer	Hayır	0	Arka plan saydamlığı, 0–100.
custom_eyes_color	boolean	Hayır	false	true ise gözler eyes_inner_color ve eyes_outer_color kullanır.
eyes_inner_color	string	Hayır	#000000	İç göz HEX rengi.
eyes_outer_color	string	Hayır	#000000	Dış göz HEX rengi.
qr_code_logo	string	Hayır	—	Logo görseli URL’si veya yüklenen dosya anahtarı.
qr_code_logo_size	number	Hayır	25	QR’nin yüzdesi olarak logo boyutu, 5–40.
frame	string	Hayır	—	Stüdyodan isteğe bağlı çerçeve anahtarı.
frame_text	string	Hayır	—	Çerçeveye çizilen başlık.

Türe göre içerik alanları

Ad	Tür	Gerekli	Varsayılan	Açıklama
phone	string	Hayır	—	type phone olduğunda telefon numarası.
sms	string	Hayır	—	type sms olduğunda telefon numarası.
sms_body	string	Hayır	—	SMS ileti gövdesi.
email	string	Hayır	—	type email olduğunda alıcı.
email_subject	string	Hayır	—	E-posta konusu.
email_body	string	Hayır	—	E-posta gövdesi.
whatsapp	string	Hayır	—	WhatsApp numarası, yalnızca rakam.
whatsapp_body	string	Hayır	—	Önceden doldurulmuş WhatsApp metni.
wifi_ssid	string	Hayır	—	type wifi olduğunda ağ adı.
wifi_password	string	Hayır	—	Wi-Fi parolası.
wifi_encryption	string	Hayır	WPA	nopass, WEP, WPA veya WPA/WPA2.
location_latitude	number	Hayır	—	type location olduğunda enlem.
location_longitude	number	Hayır	—	type location olduğunda boylam.
event	string	Hayır	—	type event olduğunda etkinlik başlığı.
event_start_datetime	string	Hayır	—	Etkinlik başlangıcı için ISO tarih-saat.
vcard first_name / last_name / email	string	Hayır	—	vCard alanları: first_name, last_name, email ve diğer stüdyo anahtarları.

İstek örneği

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

Daha fazla örnek

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

Yanıt örneği

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

Ad	Tür	Gerekli	Açıklama
page	integer	Hayır	Page number (default 1)
results_per_page	integer	Hayır	Items per page (default 25, max 100)
search	string	Hayır	Search term
search_by	string	Hayır	Column to search
order_by	string	Hayır	Sort column
order_type	string	Hayır	asc or desc
datetime_start	string	Hayır	ISO datetime filter start
datetime_end	string	Hayır	ISO datetime filter end
project_id	integer	Hayır	—
type	string	Hayır	—

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

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

Bir QR kodu oku

Ad	Tür	Gerekli	Açıklama
id	integer	Evet	—

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

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

QR kodu güncelle

Ad	Tür	Gerekli	Varsayılan	Açıklama
id	integer	Evet	—	—
name	string	Hayır	—	Kaynakta saklanan etiket.
type	string	Hayır	url	İçerik türü. Desteklenen QR anahtarlarından biri, file hariç.
url	string	Hayır	—	Hedef URL. type url olduğunda zorunlu.
text	string	Hayır	—	Düz metin. type text olduğunda zorunlu. Toplu metinde satırları bu alanda ayırın.
url_dynamic	boolean	Hayır	false	true ise kısa bağlantı oluşturulur ve QR o bağlantıyı kodlar; hedef sonradan değiştirilebilir.
project_id	integer	Hayır	—	Kaynağın ekleneceği proje.
is_bulk	boolean	Hayır	false	true ve type text ise text içindeki her satır için bir QR oluşturulur.
style	string	Hayır	square	Modül şekli. Örnekler: square, dot, rounded, heart, hexagon.
inner_eye_style	string	Hayır	square	İç bulucu deseni şekli. Örnekler: square, dot, circle, rounded.
outer_eye_style	string	Hayır	square	Dış bulucu deseni şekli. Örnekler: square, circle, rounded, flower.
size	integer	Hayır	500	Piksel cinsinden görüntü boyutu, 50–2000.
margin	integer	Hayır	0	Sessiz bölge modülleri, 0–25.
ecc	string	Hayır	M	Hata düzeltme: L, M, Q veya H. Logo eklerken H kullanın.
foreground_type	string	Hayır	color	color veya gradient.
foreground_color	string	Hayır	#000000	HEX olarak modül rengi.
foreground_gradient_style	string	Hayır	horizontal	vertical, horizontal, diagonal, inverse_diagonal veya radial.
foreground_gradient_one	string	Hayır	—	İlk gradyan HEX rengi.
foreground_gradient_two	string	Hayır	—	İkinci gradyan HEX rengi.
background_color	string	Hayır	#ffffff	Arka plan HEX rengi. Modüllerden daha açık tutun.
background_color_transparency	integer	Hayır	0	Arka plan saydamlığı, 0–100.
custom_eyes_color	boolean	Hayır	false	true ise gözler eyes_inner_color ve eyes_outer_color kullanır.
eyes_inner_color	string	Hayır	#000000	İç göz HEX rengi.
eyes_outer_color	string	Hayır	#000000	Dış göz HEX rengi.
qr_code_logo	string	Hayır	—	Logo görseli URL’si veya yüklenen dosya anahtarı.
qr_code_logo_size	number	Hayır	25	QR’nin yüzdesi olarak logo boyutu, 5–40.
frame	string	Hayır	—	Stüdyodan isteğe bağlı çerçeve anahtarı.
frame_text	string	Hayır	—	Çerçeveye çizilen başlık.

İstek örneği

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 kodu sil

Ad	Tür	Gerekli	Açıklama
id	integer	Evet	—

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

Parametre adları ve JSON örnekleri İngilizce gösterilir. YOUR_API_KEY'i hesap anahtarınızla değiştirin.