Guia pràctica de Qivo
Com funciona una API de generació de codi QR
Una API li permet generar codis QR automàticament des del seu lloc web, eina interna o guió.
La seva aplicació envia contingut i configuracions; Qivo torna una imatge QR estàtica.
Des d'un editor manual fins a una integració
En l'editor, una persona omple els camps i clics per descarregar. amb una API, un programa realitza aquestes accions, per exemple, generant un codi QR de la pàgina de producte mentre prepara una etiqueta.
Una trucada d'API no fa dinàmic el codi. La imatge emmagatzema les dades enviades en lloc d'una URL Qivo intermediària. Es pot guardar i utilitzar el fitxer sense contactar de nou amb el generador.
Què conté una sol·licitud
Una sol·licitud GET conté l'adreça del servei, els paràmetres i una clau secreta. El contingutTip de paràmetre selecciona el tipus de dades, el format selecciona PNG o SVG, i la forma, la frontera i el centre controlen el disseny.
Els valors dels paràmetres han de ser codificats per URL. Utilitza les eines estàndard del seu idioma per gestionar correctament els espais, els + en els números de telèfon i els # en els colors. Els camps invalid o faltant causen una resposta d'error.
Per què la clau pertany al vostre servidor
Els visitants poden llegir una clau col·locada en el JavaScript d'una pàgina pública.Enviar sol·licituds del servidor i carregar la clau d'una variable mediambiental.
Envia la clau a l'encara X-API sobre HTTPS. El paràmetre d'URL clau també es dóna suport, però les URL poden aparèixer en la història i els registres. Mai posar la clau secreta en la imatge QR o exemples públics.
Com gestionar la resposta
Una resposta exitosa conté la imatge mateixa, no JSON amb un enllaç de descàrrega. comprovar l'estat HTTP abans d'emmagatzemar. Errors retornar JSON amb una explicació; no emmagatzemar-ho com un PNG.
SVG és útil per a materials impresos, mentre que PNG s'adapta a les imatges diàries. Eviteu la regeneració d'un codi en cada visita a una pàgina sense canvis: guardar i reutilitzar el fitxer. Respecteu els límits de sol·licitud i el retard després de la retirada.
Què comprovar abans de publicar
L'API valida la entrada però no decodifica l'imatge finalitzada. Això redueix el processament, però el seu flux de treball ha de gestionar la prova d'escaneig.
Deixeu una zona tranquil·la de almenys quatre mòduls, un bon contrast i una mida suficient. Escaneu el disseny final d'impressió amb un telèfon. La pàgina API conté paràmetres tècnics i exemples de PHP, JavaScript, Python i cURL preparats per utilitzar.
Fonts i més lectura
Preparat i mantingut per Umind. Testar aquestes recomanacions en el seu disseny final i els dispositius objectius.