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 adres | https://esnekqr.com/api/v1 |
|---|---|
| Kimlik doğrulama | Authorization: Bearer eqk_... (alternatif: X-API-Key: eqk_...) |
| Gövde | Content-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çimi | ISO 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." } }
| HTTP | code | Anlamı |
|---|---|---|
| 401 | unauthorized | Anahtar yok, geçersiz veya iptal edilmiş |
| 403 | plan_no_api, blocked | Paketinizde API yok / QR yönetici tarafından engellenmiş |
| 404 | not_found | QR veya adres bulunamadı |
| 422 | validation_error | İçerik geçersiz, paket limiti dolu, engelli alan adı vb. (mesaj Türkçe açıklar) |
| 429 | rate_limited | Dakikalık istek sınırı aşıldı |
Uç noktalar
/meHesap, paket ve kullanım/qrQR listesi (sayfalı)/qrDinamik QR oluştur/qr/{id}QR ayrıntısı/qr/{id}/updateGüncelle (PATCH /qr/{id} de olur)/qr/{id}/pauseDuraklat/qr/{id}/activateYeniden etkinleştir/qr/{id}/deleteSil (DELETE /qr/{id} de olur)/qr/{id}/stats?days=30Tarama istatistikleri/foldersKlasörlerQR 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": {}
} }
| Alan | Açıklama |
|---|---|
type * | QR türü (aşağıdaki tablo) |
content * | Türe göre içerik nesnesi |
title | Panelde görünen ad (en fazla 150 karakter) |
folder_id | Klasör (GET /folders) |
design | Renk / desen ayarları (panelde oluşturulan bir QR'ın design alanını örnek alabilirsiniz) |
password | Şifre koruması |
expires_at, scan_limit | Son kullanma tarihi / tarama limiti |
rules | Akı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ı
| type | content alanları |
|---|---|
url | url* |
vcard | first_name, last_name, org (en az biri), title, phone_mobile, phone_work, email, website, street, city, zip, country, note |
wifi | ssid*, password, encryption (WPA, WEP, nopass), hidden (true/false) |
whatsapp | phone* (ülke koduyla, ör. 905321234567), message |
google_review | place_id*, business |
iban | name*, iban*, bank, amount, currency (TRY, USD, EUR), description |
text | text* |
phone | phone* |
email | to*, subject, body |
sms | phone*, message |
location | address veya lat + lng |
event | summary*, start* (2026-11-20T19:00), end, all_day, location, description |
app | app_name, ios_url, android_url, fallback_url (en az biri) |
coupon | headline*, discount, code, valid_until, description, terms, button_text, button_url |
social | name*, bio, links*: [{"platform":"instagram","url":"https://..."}] |
menu | restaurant*, 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
- API ile oluşturulan QR'lar paketinizdeki dinamik QR hakkından düşer; panelde de görünür.
- Panel ile aynı güvenlik kontrolleri uygulanır: zararlı / engelli alan adlarına yönlendirme yapılamaz, bir dinamik QR başka bir EsnekQR kısa bağlantısına yönlenemez.
- Silinen QR'ın kısa bağlantısı hiçbir zaman başka bir QR'a verilmez.
- Toplu işlemlerde dakikalık sınırı aşmamak için istekleri sıraya koyun (ör. saniyede 2 istek).
Sorularınız ve özel entegrasyon talepleriniz için: İletişim