QR kodu oluşturma
Bir kod oluşturmak için https://store.mavibot.ai/function/qrcode\\_generator fonksiyonunu kullanmanız gerekir;
Parametreler:
text_for_qr - kodlanması gereken metin
api_key - proje ayarlarından alınan API erişim anahtarı
#{api_key} değerini ayarlardaki token ile değiştirin
Örnek:
"URL isteği" alanına şunu yapıştırın: https://store.mavibot.ai/function/qrcode\\_generator
"Kaydedilen değerler" alanına kaydetmek istediğiniz değişkenleri yapıştırın (gerekli URL qr_image_url içindedir):
status->status;
qr_image_url->qr_image_url
"JSON parametreleri" alanına şunu yazın:
{"text_for_qr":"Kodlanacak metin","api_key":"8629fe13ba9efebefd27a7afd701767f"}
Fonksiyon, status ve qr_image_url parametrelerini içeren bir json döndürür
Barkod oluşturma
Bir kod oluşturmak için https://store.mavibot.ai/function/barcode\\_generator fonksiyonunu kullanmanız gerekir;
Parametreler:
text_for_qr - kodlanması gereken metin
api_key - proje ayarlarından alınan API erişim anahtarı
class - oluşturmak istediğiniz kod sınıfı. Varsayılan olarak ea13'tür. Şu değerleri alabilir: 'code39', 'code128', 'ean', 'ean13', 'ean8', 'gs1', 'gtin', 'isbn', 'isbn10', 'isbn13', 'issn', 'jan', 'pzn', 'upc', 'upca'
without_text - (isteğe bağlı bir parametre) herhangi bir değer verirseniz, barkod aşağıdaki resimde gösterildiği gibi metin olmadan görüntülenir.
#{api_key} değerini ayarlardaki token ile değiştirin
Örnek: {"text":"#{barcode}","api_key":"#{api_key}", "class": "ean13"}
Fonksiyon, başarılı olursa status ve qr_image_url parametrelerini, başarısız olursa error_message parametresini içeren bir json döndürür
Örnek metin barcode değişkeninde saklanır ve image_url değişkeni görsel olarak göndermek için kullanılır.
Görselden barkod tanıma
Bunu, ürün kodlarını tarayan bir bot oluşturmak için kullanabilirsiniz. Kullanışlı bir özellik, aynı zamanda QR kodlarını da tarayabilmesidir.
Bir görseldeki barkodu tanıyan fonksiyonun adresi https://store.mavibot.ai/function/cv2barcode;
Bir görseli taramak için bloktan şu parametreleri göndermeniz gerekir:
{"photo":"barkod/QR kodunun bağlantısı veya bağlantıyı içeren değişken","api_key":"ayarlardan alınan API erişim anahtarı"}
Örneğin, tarama için bir görsel göndermek için şu parametreleri göndermeniz gerekir:
"Kullanıcı veri girer" alanındaki oka #{attachments} değişkenini girin.
Kod örneği:
{"photo":"#{attachments}","api_key":"8629fe13ba9efebefd27a7afd701767f"}
photo barkod görselinin bağlantısıdır; bizim durumumuzda, bot'a gönderilen görselin bağlantısını tutan değişkendir.
Bir sonraki parametre api_key - proje ayarlarından alınan API erişim anahtarıdır
Fonksiyon şu şekilde çalışır:
İstemci bir barkod resmi gönderir, fonksiyon onu tarar ve başarılı olursa, işlem durumu "ok" olarak ayarlanmış şekilde barkod numarasını döndürür.
barcode -> "4500000000567" status -> "ok"
Tarama durumu şunlar olabilir:
- ok — barkod tanındı
- barcode not recognized — adından da anlaşılacağı gibi, barkod tanınamadı
- error image reading — görsel okunurken bir hata oluştu
- error subscription — bu özellik mevcut abonelik planınızla kullanılamaz
status değişkeni, istemciyi uygun bloğa yönlendirmek için bir ok üzerinde koşul olarak kullanılabilir.
Örneğin, bir okun koşulu status'un "barcode not recognized" değerine eşit olup olmadığını kontrol ediyorsa, "Kod tanınamadı, lütfen tekrar deneyin" mesajını görüntüleyebilir ve istemciden fotoğrafı tekrar göndermesini isteyebilirsiniz.