Qivo Uygulama Kılavuzu
Bir QR kodu oluşturma API nasıl çalışır
Bir API, web sitenizden, iç araçtan veya senaryoya otomatik olarak QR kodları oluşturmanıza olanak tanır.
Uygulamanız içeriği ve ayarları gönderir; Qivo statik bir QR görüntüsü verir.
Bir manuel editörden bir entegrasyona kadar
Bir API ile, bir program bu eylemleri gerçekleştirir, örneğin bir ürün sayfası QR kodu oluştururken bir etiket hazırlar.
Bir API çağrısı kodu dinamik yapmaz. görüntü, gönderilen verileri orta Qivo URL'den ziyade kaydeder. dosyayı yeniden jeneratörle iletişime geçmeden kaydedebilir ve kullanabilirsiniz.
Bir talep ne içerir
Bir GET isteği servis adresi, parametreleri ve gizli bir anahtar içerir. içerikType parametresi veri türünü seçer, format PNG veya SVG'yi seçer ve şekil, sınır ve merkez tasarımı kontrol eder. düz metin veri alanını gerektirir.
Parametreler değerleri URL kodlanmış olmalıdır. dilinizin standart araçlarını kullanarak alanları, telefon numaralarında + ve renklerde #'u doğru bir şekilde ele alabilirsiniz. Gerekli alanların geçersiz veya eksikliği bir hata yanıtına neden olur.
Anahtarın Neden Sunucuya Sahip Olduğu
Anahtar, nesil erişimi sağlar.Ziyaretçiler bir kamu sayfasının JavaScript'ine yerleştirilen bir anahtarı okuyabilir.Serverinizden talepleri gönderin ve anahtarı bir çevre değişkeninden yükleyin.
Anahtar URL parametresi de desteklenir, ancak URL'ler geçmişte ve günlüğünde görünebilir. Gizli anahtarınızı QR görüntüsüne veya kamu örneklerine asla koymayın.
Cevabı nasıl ele alacağız
Başarılı bir cevap, indirme bağlantısı olan JSON değil resim içerir. kaydetmeden önce HTTP durumunu kontrol edin. Hatalar açıklama ile JSON'u geri getirir; PNG olarak kaydetmeyin.
SVG basılı malzemeler için yararlıdır, PNG ise günlük görüntüleri içerir. değiştirilmemiş bir sayfaya her ziyarette bir kodun yenilenmesini önleyin: dosyayı kaydedin ve yeniden kullanın. talep sınırlarına ve geri dönüş sonrası gecikme sınırlarına saygı gösterin.
Yayın yapmadan önce ne kontrol etmeliyim
API girişleri doğrulamaktadır ama bitmiş görüntüyi dekore etmez. bu işlemleri azaltır, ancak çalışma akışınız tarama testleri ile uğraşmalıdır. tipik tasarım kombinasyonlarını ve beklediğiniz en büyük veri hacmini test edin.
En az dört modül, iyi kontrast ve yeterli büyüklükte hafif bir sessiz bölge bırakın. telefonla son basılı düzenin taraması. API sayfasında teknik parametreler ve kullanıma hazır PHP, JavaScript, Python ve cURL örnekleri bulunur.
Kaynaklar ve daha fazla okuma
Umind tarafından hazırlanmış ve sürdürülmüş. bu önerileri nihai düzeninizde ve hedef cihazlarınızda test edin.