Qivo практикалық нұсқаулықтары
QR-код генерациясының API қалай жұмыс істейді?
API сайттан, ішкі құралдан немесе скрипттен QR-кодтарды автоматты жасауға мүмкіндік береді. Мазмұннан дайын суретке дейінгі жолды қарастырайық.
Қолданбаңыз мазмұн мен параметрлерді жібереді; Qivo статикалық QR суретін қайтарады. Құпия кілт өз серверіңізде қалады.
Қолмен өңдеуден интеграцияға дейін
Редакторда адам өрістерді толтырып, жүктеуді басады. API арқылы бұл әрекетті бағдарлама атқарады: мысалы, жапсырма дайындағанда тауар бетінің QR-кодын жасайды.
API сұрауы кодты динамикалық етпейді. Сурет аралық Qivo URL мекенжайын емес, берілген деректерді сақтайды. Файлды генераторға қайта жүгінбей сақтап, қолдана аласыз.
Сұрау неден тұрады?
GET сұрауы сервис мекенжайын, параметрлерді және құпия кілтті қамтиды. contentType дерек түрін, format PNG не SVG пішімін таңдайды; shape, border және center дизайнды басқарады. Қарапайым мәтінге data өрісі керек.
Параметр мәндерін URL үшін кодтау қажет. Бос орын, телефондағы + және түстегі # таңбасын дұрыс беру үшін тілдің стандартты құралдарын қолданыңыз. Қате не жетіспейтін міндетті өрістер қате жауабын туғызады.
Кілт неге серверде сақталуы керек?
Кілт генерацияға қолжетімділік береді. Ашық беттегі JavaScript ішіне қойылған кілтті келушілер оқи алады. Сұрауды өз серверіңізден жіберіп, кілтті орта айнымалысынан алыңыз.
Кілтті HTTPS арқылы X-API-Key тақырыбында беріңіз. key URL параметрі де бар, бірақ URL тарихта не журналда қалуы мүмкін. Құпия кілтті QR суретіне не ашық мысалдарға қоспаңыз.
Жауапты қалай өңдеу керек?
Сәтті жауап жүктеу сілтемесі бар JSON емес, суреттің өзін қамтиды. Сақтар алдында HTTP мәртебесін тексеріңіз. Қателер түсіндірмесі бар JSON қайтарады; оны PNG ретінде сақтамаңыз.
SVG баспаға, PNG күнделікті суреттерге ыңғайлы. Өзгермейтін бет ашылған сайын кодты қайта жасамаңыз: файлды сақтап, қайта пайдаланыңыз. Сұрау шегін және Retry-After кідірісін сақтаңыз.
Жариялар алдында нені тексеру керек?
API енгізілген параметрлерді тексереді, бірақ дайын суретті декодтамайды. Бұл өңдеуді қысқартады, алайда сканерлеуді сіздің жұмыс үдерісіңіз тексеруі керек. Әдеттегі дизайн үйлесімдерін және ең үлкен күтілетін дерек көлемін сынаңыз.
Кемінде төрт модуль ашық жиек, жақсы контраст және жеткілікті өлшем қалдырыңыз. Соңғы баспа макетін телефонмен сканерлеңіз. API бетінде техникалық параметрлер мен PHP, JavaScript, Python және cURL мысалдары бар.
Дереккөздер және қосымша материалдар
Umind әзірлейді және қолдайды. Ұсынымдарды соңғы макетте және мақсатты құрылғыларда тексеріңіз.