Qdestera QR kod API'si, ekibinizin panelde yaptığı işleri yazılımınıza yaptırır. Dinamik link QR kodları ve kısa linkler oluşturun, hedefleri güncelleyin, kodları açıp kapatın ve QR görsellerini indirin; kapsamlı API anahtarları ve her tarama için imzalı webhook'larla.
API'nin 1. sürümü, dinamik QR kodlar ve kısa linklerle ilgili günlük işleri kapsar.
API, HTTPS üzerinden JSON konuşan sade bir REST arayüzüdür. Her istek tek bir çalışma alanına ait bir API anahtarıyla yapılır; böylece bir entegrasyon yalnızca o çalışma alanının kodlarını ve linklerini görür.
Okuma işlemleri okuma kapsamı, veriyi değiştiren her işlem yazma kapsamı ister.
| İşlem | QR kodlar | Kısa linkler |
|---|---|---|
| Sayfalı listeleme | Evet | Evet |
| Kimliğe göre getirme | Evet | Evet |
| Oluşturma | ✓ (dinamik link) | Evet |
| Hedefi ve bilgileri güncelleme | Evet | Evet |
| Aktif ya da pasif yapma | Evet | Evet |
| Silme | Evet | Evet |
| Görsel indirme | ✓ (PNG) | Hayır |
| Kapsamlar | qr:read, qr:write | link:read, link:write |
Panelinizde tek bir entegrasyon için anahtar oluşturun. Yalnızca gereken kapsamları verin (qr:read, qr:write, link:read ya da link:write) ve isterseniz bir son kullanma tarihi belirleyin.
Oturumunuz açıkken 1. sürümün OpenAPI dokümanını API istemcinize ya da kod üreticinize yükleyin. Tüm uç noktaları, parametreleri ve yanıtları anlatır.
Anahtarı bir istek başlığında gönderin ve bir uç noktayı çağırın; örneğin kodlarınızı listelemek için GET /api/v1/qrcodes. Yanıtlar JSON biçimindedir. Liste uç noktaları sayfalı çalışır; arama ve durum filtresiyle yalnızca ihtiyacınız olan kayıtları çekebilir, büyük hesaplarda bile yanıtları küçük ve hızlı tutabilirsiniz.
Her anahtarın planınıza bağlı bir hız limiti vardır. Limit aşılırsa API, HTTP 429 ve Retry-After başlığıyla yanıt verir; istemciniz ne zaman yeniden deneyeceğini bilir.
Mağaza sisteminizin yeni bir ürün eklediğini ve etiketi için QR koda ihtiyaç duyduğunu düşünün. Önce POST /api/v1/links ile ürün sayfasına giden bir kısa link oluşturur. Ardından POST /api/v1/qrcodes ile bu link için dinamik bir link QR kodu oluşturur ve etiket yazıcısı için PNG'yi GET /api/v1/qrcodes/{id}/image ile alır.
Aylar sonra ürün sayfasının adresi değişir. Sisteminiz yeni hedefle tek bir güncelleme isteği gönderir; raftaki tüm etiketler bir sonraki taramada doğru sayfayı açar. İsteklerin alanları OpenAPI dokümanında ayrıntılı olarak yer alır.
Aynı yöntem biletler, sertifikalar, ambalaj serileri ya da toplu oluşturulan ürün QR kodları için de işler: veriyi sisteminiz tutar, kodların çalışmasını Qdestera sağlar.
Bir kampanya bittiğinde de aynı mantık geçerlidir. Sisteminiz ilgili kodları tek tek pasife alabilir; okutan kişiler içeriğiniz yerine bir bilgilendirme görür. Kampanya yeniden başladığında kodları tekrar aktif yapmak için yine tek bir istek yeterlidir. Böylece panelde elle yapacağınız toplu işleri zamanlanmış görevlere ya da kendi iş akışlarınıza bağlayabilirsiniz.
Her entegrasyon için ayrı anahtar oluşturun, QR kodlar ve linkler için okuma ya da yazma yetkisiyle sınırlayın; proje bitince anahtarın süresi kendiliğinden dolsun.
Tek bir kodun, bir klasörün ya da tüm çalışma alanının her taramasında HTTP çağrısı alın. Her istek HMAC-SHA256 ile imzalanır, başarısız gönderimler yeniden denenir ve teslimat kaydı her gönderimi listeler.
API'nin etrafındaki insanlar da aynı çalışma alanında çalışır. Ekip arkadaşlarınızı Sahip, Yönetici, Editör ya da Görüntüleyici olarak davet edin; değişiklikleri denetim kaydında izleyin.
Webhook'lar tarama otomasyonlarının bir parçasıdır. Kapsamı (tek kod, bir klasör ya da tüm çalışma alanı) ve çağrıyı alacak uç noktayı siz seçersiniz. Her taramada Qdestera olayı uç noktanıza gönderir.
Her istek, yalnızca bizimle paylaştığınız bir gizli anahtarla hesaplanan HMAC-SHA256 imzası taşır. İmzayı kendi tarafınızda yeniden hesaplayın ve eşleşmeyen her isteği reddedin. Uç noktanız erişilemezse gönderim yeniden denenir; teslimat kaydında her gönderimi ve durumunu görürsünüz. Aynı taramalar QR kod analitiği ekranınızda da yer alır.
ERP ya da e-ticaret sisteminizden her ürün veya parti için doğrudan karekod üretin.
Pazarlama ajansları müşteri kodlarını kendi kampanya araçlarından oluşturup yönetir.
Bir taramayı CRM aktivitesine, sohbet mesajına ya da raporlama veritabanınızda bir satıra dönüştürün.
Kodları ve linkleri ekibinizin her gün kullandığı araçlara çekin.
Ayrı anahtarlar, diğerlerine dokunmadan tek bir entegrasyonun anahtarını yenilemeyi ya da iptal etmeyi kolaylaştırır.
Bir raporlama betiğine okuma kapsamı yeter. Yazma kapsamını yalnızca kod oluşturan ya da değiştiren sistemlere verin. Geçici projelerde anahtara mutlaka bir son kullanma tarihi ekleyin.
API anahtarını asla mobil uygulamaya, tarayıcı betiğine ya da herkese açık bir depoya koymayın.
Webhook isteğinin içeriğine güvenmeden önce HMAC-SHA256 imzasını kontrol edin.
HTTP 429 aldığınızda yeniden denemeden önce Retry-After başlığındaki süre kadar bekleyin.
Linkleri özel alan adınızda oluşturun; API ile üretilen kodlar da sizin adınızı taşısın.
API anahtarları düz metin olarak değil, özet (hash) olarak saklanır ve her anahtar yalnızca kendisini oluşturan çalışma alanında çalışır. Panel, her anahtarın en son ne zaman kullanıldığını gösterir; unutulmuş entegrasyonları bu sayede kolayca fark edersiniz.
Bir anahtarın sızmış olabileceğinden şüpheleniyorsanız, yeni bir gizli değer almak için anahtarı yenileyin ya da hemen devre dışı bırakmak için iptal edin. Anahtar oluşturma işlemleri çalışma alanının denetim kaydına yazılır; yöneticiler hangi entegrasyonu kimin kurduğunu görebilir.
Kısacası API, panelde uyguladığınız kurallarla aynı sınırlar içinde çalışır: aynı çalışma alanı, aynı plan limitleri ve aynı izolasyon. Entegrasyonunuz ne kadar büyürse büyüsün, başka bir çalışma alanının verisine erişemez.
Hesap açın, ihtiyacınız olan kapsamlarla bir API anahtarı oluşturun ve ilk isteğinizi gönderin.
Başka bir sorunuz mu var? Rehberlerimize göz atın ya da bize ulaşın .
Evet. Qdestera REST API'sinin 1. sürümüyle dinamik link QR kodları ve kısa linkler oluşturabilir; bunları listeleyebilir, güncelleyebilir, aktif ya da pasif yapabilir ve silebilirsiniz.
Panelinizde bir API anahtarı oluşturun ve her istekte bir başlıkla gönderin. Her anahtar tek bir çalışma alanına aittir ve kendi kapsamları vardır.
qr:read, qr:write, link:read ve link:write. Bunları birleştirebilir, anahtara isteğe bağlı bir son kullanma tarihi verebilirsiniz.
Evet, anahtar başına ve planınıza bağlı olarak. Limit aşıldığında API, Retry-After başlığıyla HTTP 429 döner.
Evet. Bir QR kodun görselini kimliğiyle isteyin, oluşturulmuş PNG dosyasını alırsınız.
Evet. 1. sürümün tüm uç noktalarını anlatan bir OpenAPI dokümanı var; oturumunuz açıkken açıp API istemcinize aktarabilirsiniz.
Evet, tarama otomasyonlarıyla. Her taramada HMAC-SHA256 ile imzalanmış bir webhook çağrılır; yeniden deneme ve teslimat kaydı dahildir.
1. sürüm dinamik link QR kodları oluşturur. Diğer türler panelde oluşturulur, ardından API ile listelenip yönetilebilir.
Evet. Kısa link oluştururken çalışma alanınızda doğrulanmış ve aktif olan bir özel alan adını seçebilirsiniz.
Evet. Gizli değerini değiştirmek için anahtarı yenileyin ya da hemen çalışmaz hâle getirmek için iptal edin. Panel her anahtarın en son ne zaman kullanıldığını da gösterir.
Kapsamlı API anahtarları, dokümanlı bir REST API ve imzalı webhook'lar; hesabınız hazır olduğunda hazır.