КИВО Практични водичи
Како функционише АПИ за генерисање КР кода
АПИ вам омогућава да аутоматски генеришете КР кодове са вашег сајта, унутрашњег алата или скрипта.
Ваша апликација шаље садржај и подешавања; Qivo враћа статичку КР слику. тајни кључ остаје на вашем серверу.
Од ручног уређаја до интеграције
У уређају, особа испуњава поље и кликне на преузимање. са АПИ-ом, програм обавља ове акције, на пример, генеришући КР код странице производа док припрема етикету.
АПИ позив не чини код динамичним. слика складишти подате податке уместо интерметарног КИВО УРЛ-а. Можете сачувати и користити датотеку без контакта са генератором поново.
Шта захтев садржи
Захтев за ГЕТ садржи услужну адресу, параметре и тајни кључ. садржајТип параметара бира тип података, формат бира ПНГ или СВГ, а облик, граница и центар контролише дизајн.
Вредности параметара морају бити URL-кодирани. користите стандардне алате вашег језика да правилно управљају просторима, + у телефонским бројевима и # у бојама. Неважеће или недостају потребне поље узрокују одговор грешке.
Зашто је кључ на вашем серверу
Кључ омогућава приступ генерацији.Посетиоци могу да прочитају кључ постављен у јавном JavaScript-у.Пошаљите захтеве са вашег сервера и преузмите кључ из променљиве средине.
Пошаљите кључ у X-API-Кључни наслов преко ХТТПС-а. Кључни URL параметар се такође подржава, али се УРЛ-а могу појавити у историји и записима. Никада не ставите тајни кључ у КР слику или јавне примере.
Како се носити са одговором
Успешан одговор садржи саму слику, а не ЈСОН са линком за преузимање. проверите статус ХТТП пре него што сачувате. грешке враћају ЈСОН са објашњењем; не сачувате то као ПНГ.
СВГ је користан за штампане материјале, док ПНГ одговара свакодневним сликама. Избегавајте регенерисање кода на сваком посету непромењеној страници: сачувате и поново користите датотеку. Поштујте ограничења захтева и повратне кашњења.
Шта проверити пре објављивања
АПИ валидира улаз, али не декодира завршену слику. ово смањује обраду, али ваш радни ток мора да се бави скенирањем тестирања. тестирати типичне комбинације дизајна и највеће количине података које очекујете.
Оставите лагану тиху зону од најмање четири модула, добар контраст и довољну величину. Скенирајте коначни штампани распоред са телефоном. Страница АПИ садржи техничке параметре и спремни за употребу примери ПХП, Јаваскрипт, Питон и ЦУРЛ.
Извори и даље читање
Припремљен и одржаван од стране Уминд. Тестирајте ове препоруке на вашем коначном распореду и циљним уређајима.