WebQR API
ბრენდირებული QR გენერაცია თქვენი სერვერიდან
ერთი HTTP მოთხოვნა — SVG პასუხში. იგივე design ველები, რაც WebQR კონსტრუქტორში. კოდების შენახვა ჩვენს მხარეს არ ხდება.
ძირითადი შესაძლებლობები
გენერაციის API
გენერირება სტატიკური QR-კოდების API-ით: გაგზავნეთ სტრიქონი და design ობიექტი — მიიღეთ წამებში SVG.
დიზაინი და ბრენდინგი
გამოიყენეთ ბრენდის ფერები, მოდულების ფორმები, ჩარჩოები და ლოგოები — ყველაფერი design ობიექტის მეშვეობით.
WebQR-ზე შენახვა არა
API stateless-ია WebQR-ში: სერვერზე ბიბლიოთეკა არ ინახება. შეინახეთ SVG და მეტადატა თქვენს სისტემაში.
რატომ ირჩევენ WebQR API-ს
Stateless REST, design-ის სრული კონტროლი და პრогნოზირებადი კვოტა.
SVG მოცემულ პასუხში
POST /v1/generate იღებს data სტრიქონს და design ობიექტს — პასუხში მზა SVG data.qr_code-ში.
Design როგორც კონსტრუქტორში
ბრენდის ფერები, მოდულები, თვალები, ჩარჩოები და ლოგო — იგივე ველები, რაც კაბინეტში.
გრადიენტი და სტილები
გრადიენტი, მომრგვალება, გამჭვირვალე ფონი — ყველაფერი JSON-ით.
Stateless — WebQR-ზე შენახვა არა
API არ ინახავს payload-ს და არ იძლევა მუდმივ id-ებს. SVG და მეტამონაცემები — თქვენს სერვერზე.
გამჭვირვალე თვიური კვოტა
წარმატებული გენერაცია ითვლება included_limit-ში; GET /v1/usage აჩვენებს usage-ს კვოტის გარეშე.
გასაღებები, IP და ხელმოწერა
X-API-Key კაბინეტიდან, IP whitelist და არჩევითი HMAC production-ისთვის.
ჩართული გენერაციები თვეში
წარმატებული POST /v1/generate SVG-ით = +1 used_count. კვოტა იწყება ახალი კალენდარული თვის დასაწყისში.
Starter
200
გენერაცია / თვე
Premium
5 000
გენერაცია / თვე
Business
25 000
გენერაცია / თვე
სჭირდებათ overage — ჩართეთ API ბილინგი კაბინეტში. დეტალები: ტარიფები
სამი ნაბიჯი პირველ QR-ამდე
SDK-ის გარეშე — HTTPS და JSON ნებისმიერი backend-იდან.
-
1
შექმენით API გასაღები
WebQR კაბინეტში: ერთი ან რამდენიმე გასაღები, IP შეზღუდვა, არჩევითი ხელმოწერა.
-
2
გაგზავნეთ POST /v1/generate
X-API-Key სათაური და JSON data/design ველებით. პასუხი — SVG და usage.
-
3
შეინახეთ SVG თქვენთან
ფაილი, CDN, ბეჭედი — WebQR შედეგს არ ინახავს; id-ებს თქვენ მართავთ.
გასაღები და უსაფრთხოება
არ ჩასვათ API გასაღებები საიტებსა და აპებში — მხოლოდ სერვერიდან იძახება API.
IP სია და HMAC ხელმოწერა (იხილეთ კაბინეტის დოკუმენტაცია) ინტეგრაციას დაიცავს.
- საიდუმლო მხოლოდ სერვერზე; კლიენტებს — თქვენი HTTPS, არა API გასაღები.
- გასაღები შემოიფარგლეთ სერვერების IP-ებით (ან CDN-ის ფიქსირებული გასასვლელით).
- სურვილისამებრ ჩართეთ სავალდებულო HMAC ხელმოწერა გასაღების პარამეტრებში.
API გამოყენების ანალitika
იხილეთ დემო: უფასო და პlatიანი გენერაციები, დღიური გრafiki და API გასაღებების მიხედვით — რეგისტრაციის გარეშე.
ხშირად დასმული კითხვები
კალენდარული თვის ჩართული წარმატებული გენერაციები გეგმების მიხედვით: 200 (Starter), 5000 (Premium), 25000 (Business). თუ მეტი გჭირდებათ — დაგვიკავშირდით.
დიახ! შეგიძლიათ შექმნათ QR API-ით ან მთავარ კონსტრუქტორში.
დიახ. Starter-ში უკვე შედის Static QR API: კალენდარულ თვეში ჩართული წარმატებული გენერაციების ლიმიტია 200; Premium — 5000; Business — 25000; ნორმა იხსნება თითო ახალი კალენდარული თვის დასაწყისში. „მხოლოდ API“-ის ცალკე გამოწერა არ გჭირდებათ; საჭიროებისამებრ შეიძლება გადახდადი ოვერეიჯი.
JSON-ში იქნება SVG data.qr_code ველში, იგივე content და design რაც გაგზავნეთ, და usage კვოტისთვის. ნაკადი stateless არის: WebQR თითო API გადაცემას თქვენს QR სიაში პროექტად არ ამატებს და გრძელვადიანი ID პასუხში არ გამოდის — SVG შეინახეთ და მართეთ იქ, სადაც ინტეგრირებთ. იმას, რასაც კონსტრუქტორში შეინახავთ WebQR-ში, სწორედ იმავე კაბინეტის წესები ეხება.