QR kod API: QR kodları otomatik oluştur, değiştir ve değerlendir

QR kod API'si ne işe yarar

QR kod API'si bir programlama arayüzüdür: Tarayıcıda tıklamak yerine programın QR kod hizmetine istekler gönderir ve yanıtlar alır. Böylece QR kodlar doğrudan bir mağazadan, bir stok yönetiminden, bir betikten ya da bir tablodan oluşur.

Bu, iş tekrarlandığı anda değer kazanır: masalar ya da ürünler için yüz QR kod, aylık tarama raporları, bir yeniden yayından sonra birçok hedefin değiştirilmesi. Ve yalnızca dinamik QR kodlarla çalışır. Same-QR'ın dinamik QR kodu kısa ve sabit bir adres içerir, arkasındaki hedef bizde durur ve yeniden basmadan istediğin zaman değiştirilebilir.

Same-QR API'si neleri kapsar

REST API'si https://sameqr.com/api/v1 adresindedir. Kontrol panelindekiyle aynı işlevleri, aynı tarife sınırları ve denetimlerle çağırır:

• QR kodları listeleme, okuma, oluşturma, değiştirme ve silme.
• Bir QR kodun istatistiği: taramalar, oluşturma tarihi, hedef değişikliği sayısı.
• Menü, fiyat listesi, çalışma saatleri, bağlantı sayfası, kampanya, bağ evi, şarap E-Label'ı ve iletişim gibi konuk sayfalarını oluşturma, değiştirme, yayınlama ve çevrimdışına alma.
• Yedi fotoğraftan ya da bir PDF'ten menü tarama.
• Etiketleri ve müşteri projelerini yönetme ve iletişim formlarından gelen istekleri okuma.

Tüm isteklerin makine tarafından okunabilir bir açıklaması /api/v1/openapi.json altındadır, kılavuz ise sameqr.com/entwickler adresinde.

API anahtarı ve yetkiler

Anahtarı kontrol panelinde Hesap altında, "CLI, betikler ve ajanlar için erişim" bölümünde oluşturursun. Üç seviyeden birini seçersin: "yalnızca oku", "oku + yaz" (oluşturma, ad ve metin değiştirme) ya da "tam" (ek olarak hedef değiştirme, çevrimdışına alma, silme), ayrıca 30, 90, 180 ya da 365 günlük bir süre, gerekirse sınırsız da. Anahtar sqr_live_ ile başlar ve tam olarak bir kez gösterilir. Bizde yalnızca bir sağlama toplamı saklanır.

Yalnızca okuyabilen bir anahtar, değiştiren her istekte net bir ret alır. Raporlar ve değerlendirmeler için doğru seçim budur. Basılı bir QR kodun nereye götürdüğünü değiştiren her şey ayrıca korunur: Hedef değişikliği, çevrimdışına alma ve silme "tam" seviyesini ve önceden okunan durumla bir onay gerektirir, ve API üzerinden bunlardan saatte en fazla 10 ve günde 30 geçer. Kontrol panelinde bu sınır yoktur. Her anahtar istediğin zaman iptal edilebilir ve o zaman hemen geçersiz olur.

Tipik bir akış

Anahtar Authorization başlığına girer, asla bir adrese değil. Anahtarı önceden ortam değişkeni olarak saklarsın. QR kodlarını böyle listeler ve bir QR kodun hedefini böyle değiştirirsin:

curl -H "Authorization: Bearer $SAMEQR_API_KEY" https://sameqr.com/api/v1/qr

curl -X PATCH https://sameqr.com/api/v1/qr/<id> \
  -H "Authorization: Bearer $SAMEQR_API_KEY" -H "Content-Type: application/json" \
  -H "X-Confirm: <stand>" \
  -d '{"targetUrl":"https://example.com/karte-neu"}'

X-Confirm için değeri, yani durumu, /api/v1/qr/<id> üzerindeki okuma isteği verir. Yalnızca gönderdiğin şey değişir. Arada kimsenin aynı QR kodu değiştirmediğinden emin olmak isteyen, okunan durumu _rev olarak birlikte gönderir. Bir şey değişmişse hiçbir şey üzerine yazılmaz ve yanıt güncel durumu içerir. Hatalar her zaman aynı biçimde, durum, QR kod ve anlaşılır bir mesajla gelir.

Sınırlar ve iyi uygulama

Anahtar başına dakikada en fazla 120 istek geçer. Buna tarifeye bağlı saatlik bir sınır eklenir: ücretsiz tarifede 60, Start'ta 300, Pro'da 1.000 ve Agentur'da 5.000. Sınırlar, örneğin sonsuz döngüdeki bir betik gibi hataları yakalar ve dürüst kullanımı rahatsız etmez.

• Önce bir okuma anahtarıyla dene, sonra yaz.
• Yeni akışları tek bir QR kod üzerinde test et ve telefonla tara.
• Yeni bir hedef yetiyorsa silmekten kaçın. Silinen QR kodlar ve kısa bağlantıları geri gelmez.
• Her program için ayrı bir anahtar oluştur ve onu bir parola yöneticisinde ya da ortam değişkeninde tut.

Sonuç: Neden Same-QR

Same-QR sana API'yi pahalı bir ekstra olarak değil, her tarifede ve kontrol panelindeki aynı işlevlerle verir: QR kodlar, istatistik, menüler, konuk sayfaları, etiketler ve projeler. Buna anahtar başına net yetkiler, dürüst hata mesajları ve biri ulaşılamıyorsa sana e-postayla haber veren, tüm hedeflerin gece denetimi eklenir.

Hemen başla: sameqr.com'da ücretsiz kaydol, 20 dinamik QR kod kalıcı olarak ücretsizdir. API, CLI ve MCP sunucusu her tarifede vardır, belgeler sameqr.com/entwickler adresinde.

Sık sorulan sorular