24 Kasım Öğretmenler Günü: öğretmeninize adı yazılı NFC teşekkür kartı Kartı tasarla

QR Kod API

Kendi sisteminizden dinamik QR oluşturun, hedefini değiştirin, taramaları ölçün. Basit REST + JSON.

Başlarken

API, Kurumsal pakette yer alır. Panelinizde API anahtarları sayfasından bir anahtar oluşturun. Tüm istekler HTTPS üzerinden, JSON gövdeyle yapılır.

Temel adreshttps://esnekqr.com/api/v1
Kimlik doğrulamaAuthorization: Bearer eqk_... (alternatif: X-API-Key: eqk_...)
GövdeContent-Type: application/json, UTF-8
Hız sınırıAnahtar başına dakikada 120 istek. Yanıt başlıkları: X-RateLimit-Limit, X-RateLimit-Remaining. Aşılırsa 429 + Retry-After.
Tarih biçimiISO 8601, Türkiye saati: 2026-12-31T23:59:00

Güvenlik: Anahtarınızı yalnızca sunucu tarafında saklayın; tarayıcıda çalışan koda veya mobil uygulama içine koymayın. Sızdığını düşünürseniz panelden iptal edip yenisini oluşturun.

Yanıt biçimi ve hatalar

{ "ok": true,  "data": { ... } }
{ "ok": false, "error": { "code": "validation_error", "message": "Geçerli bir http(s) adresi girin." } }
HTTPcodeAnlamı
401unauthorizedAnahtar yok, geçersiz veya iptal edilmiş
403plan_no_api, blockedPaketinizde API yok / QR yönetici tarafından engellenmiş
404not_foundQR veya adres bulunamadı
422validation_errorİçerik geçersiz, paket limiti dolu, engelli alan adı vb. (mesaj Türkçe açıklar)
429rate_limitedDakikalık istek sınırı aşıldı

Uç noktalar

GET/meHesap, paket ve kullanım
GET/qrQR listesi (sayfalı)
POST/qrDinamik QR oluştur
GET/qr/{id}QR ayrıntısı
POST/qr/{id}/updateGüncelle (PATCH /qr/{id} de olur)
POST/qr/{id}/pauseDuraklat
POST/qr/{id}/activateYeniden etkinleştir
POST/qr/{id}/deleteSil (DELETE /qr/{id} de olur)
GET/qr/{id}/stats?days=30Tarama istatistikleri
GET/foldersKlasörler

QR oluşturma

API ile dinamik QR oluşturulur: QR'ın içinde size özel kısa bağlantı bulunur ve hedefi sonradan değiştirilebilir. Yanıttaki short_url'i QR'a dönüştürüp basabilir ya da payload alanını kendi QR kütüphanenizle çizebilirsiniz.

curl -X POST https://esnekqr.com/api/v1/qr \
  -H "Authorization: Bearer eqk_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "url",
    "title": "Masa 12",
    "content": { "url": "https://ornek.com/menu?masa=12" },
    "folder_id": 5
  }'

Yanıt (201 Created):

{ "ok": true, "data": {
  "id": 1842, "type": "url", "dynamic": true, "title": "Masa 12", "status": "active",
  "short_url": "https://esnekqr.com/q/k7m2xq9",
  "target_url": "https://ornek.com/menu?masa=12",
  "folder_id": 5, "scan_count": 0, "last_scan_at": null,
  "expires_at": null, "scan_limit": null, "has_password": false,
  "created_at": "2026-10-06T19:05:12", "updated_at": "2026-10-06T19:05:12",
  "payload": "https://esnekqr.com/q/k7m2xq9",
  "content": { "url": "https://ornek.com/menu?masa=12" }, "design": {}
} }
AlanAçıklama
type *QR türü (aşağıdaki tablo)
content *Türe göre içerik nesnesi
titlePanelde görünen ad (en fazla 150 karakter)
folder_idKlasör (GET /folders)
designRenk / desen ayarları (panelde oluşturulan bir QR'ın design alanını örnek alabilirsiniz)
passwordŞifre koruması
expires_at, scan_limitSon kullanma tarihi / tarama limiti
rulesAkıllı yönlendirme: [{"type":"device","cond":"ios","target":"https://..."}] — type: device (ios, android, mobile, desktop), lang (tr, en…), country (TR, DE…), time (09:00-18:00 veya günlerle 09:00-18:00|1,2,3,4,5; 1 = Pazartesi), ab (yüzde, ör. 50). İlk eşleşen kural uygulanır, hiçbiri eşleşmezse content hedefine gidilir.

QR türleri ve content alanları

typecontent alanları
urlurl*
vcardfirst_name, last_name, org (en az biri), title, phone_mobile, phone_work, email, website, street, city, zip, country, note
wifissid*, password, encryption (WPA, WEP, nopass), hidden (true/false)
whatsappphone* (ülke koduyla, ör. 905321234567), message
google_reviewplace_id*, business
ibanname*, iban*, bank, amount, currency (TRY, USD, EUR), description
texttext*
phonephone*
emailto*, subject, body
smsphone*, message
locationaddress veya lat + lng
eventsummary*, start* (2026-11-20T19:00), end, all_day, location, description
appapp_name, ios_url, android_url, fallback_url (en az biri)
couponheadline*, discount, code, valid_until, description, terms, button_text, button_url
socialname*, bio, links*: [{"platform":"instagram","url":"https://..."}]
menurestaurant*, currency, note, sections*: [{"name":"İçecekler","items":[{"name":"Çay","desc":"","price":"20"}]}]

İpucu: Bir türün tam yapısını görmek için panelde o türde bir QR oluşturup GET /qr/{id} ile content alanına bakabilirsiniz.

Hedefi güncelleme

Yalnızca gönderdiğiniz alanlar değişir; göndermediğiniz alanlar (kurallar, şifre, son kullanma tarihi…) korunur. Basılı QR aynı kalır.

curl -X POST https://esnekqr.com/api/v1/qr/1842/update \
  -H "Authorization: Bearer eqk_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{ "content": { "url": "https://ornek.com/yeni-menu" } }'

Şifreyi kaldırmak için "password": "", son kullanma tarihini kaldırmak için "expires_at": null gönderin.

Listeleme

GET https://esnekqr.com/api/v1/qr?page=1&per_page=50&folder_id=5&type=url&q=masa

Yanıtta meta: {"page":1,"per_page":50,"total":312}. per_page en fazla 100.

İstatistikler

GET https://esnekqr.com/api/v1/qr/1842/stats?days=30

{ "ok": true, "data": {
  "qr_id": 1842, "days": 30, "total_scans": 418, "unique_scans": 297,
  "daily": [ { "date": "2026-10-05", "scans": 21, "unique": 17 } ],
  "devices": [ { "name": "mobile", "scans": 401 } ],
  "os": [ { "name": "iOS", "scans": 230 } ],
  "countries": [ { "name": "TR", "scans": 399 } ],
  "languages": [ { "name": "tr", "scans": 380 } ]
} }

days, paketinizin istatistik süresiyle sınırlıdır. Botlar sayılmaz; tekil tarama, aynı cihazın 24 saat içindeki tekrarlarını bir sayar.

Kod örnekleri

PHP

$ch = curl_init('https://esnekqr.com/api/v1/qr');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ESNEKQR_KEY'), 'Content-Type: application/json'],
  CURLOPT_POSTFIELDS => json_encode(['type' => 'url', 'title' => 'Ürün 1001',
                                     'content' => ['url' => 'https://ornek.com/urun/1001']]),
]);
$res = json_decode(curl_exec($ch), true);
echo $res['data']['short_url'];

Node.js

const r = await fetch('https://esnekqr.com/api/v1/qr', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.ESNEKQR_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ type: 'url', title: 'Ürün 1001', content: { url: 'https://ornek.com/urun/1001' } })
});
const { data } = await r.json();
console.log(data.short_url);

C# (.NET)

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization = new("Bearer", Environment.GetEnvironmentVariable("ESNEKQR_KEY"));
var body = new StringContent("{\"type\":\"url\",\"title\":\"Ürün 1001\",\"content\":{\"url\":\"https://ornek.com/urun/1001\"}}",
                             System.Text.Encoding.UTF8, "application/json");
var res = await http.PostAsync("https://esnekqr.com/api/v1/qr", body);
Console.WriteLine(await res.Content.ReadAsStringAsync());

Kurallar ve sınırlar

Sorularınız ve özel entegrasyon talepleriniz için: İletişim