Qivo praktische gids
Hoe een QR code generatie API werkt
Een API maakt het mogelijk om automatisch QR-codes te genereren van uw website, interne tool of script.
Uw applicatie stuurt inhoud en instellingen; Qivo geeft een statische QR-afbeelding terug.
Van een handboek editor tot een integratie
In de redactie vult een persoon de velden en klikt u op het downloaden. met een API uitvoert een programma deze acties, bijvoorbeeld door een productpagina QR-code te genereren terwijl een etiket wordt bereid.
Een API-oproep maakt de code niet dynamisch. de afbeelding slaat de ingediende gegevens in plaats van een Qivo-URL. U kunt het bestand opslaan en gebruiken zonder opnieuw contact op te nemen met de generator.
Wat een verzoek bevat
Een GET-verzoek bevat de serviceadres, parameters en een geheime sleutel. de contentType parameter selecteert de gegevenstype, format selecteert PNG of SVG, en vorm, grens en centrum controleert het ontwerp.
Parameterwaarden moeten URL-coded zijn. Gebruik standaardtools van uw taal om ruimtes, de + in telefoonnummers en de # in kleuren correct te beheren. Invalide of ontbrekende vereiste velden veroorzaken een foutrespons.
Waarom de sleutel bij uw server behoort
De sleutel geeft toegang tot generatie.Bezoekers kunnen een sleutel lezen die is geplaatst in een openbare pagina JavaScript.Send verzoeken van uw server en laad de sleutel van een omgevingsvariabele.
Stuur de sleutel in de X-API-Key header over HTTPS. De sleutel URL parameter wordt ook ondersteund, maar URL's kunnen verschijnen in geschiedenis en logs. Never put your secret key in the QR image or public examples.
Hoe om te gaan met de reactie
Een succesvolle reactie bevat de afbeelding zelf, niet JSON met een downloadlink. Check de HTTP-status voor het opslaan. Erfels retourneren JSON met een verklaring; sla dat niet als een PNG.
SVG is nuttig voor gedrukte materialen, terwijl PNG dagelijks afbeeldingen past. Vermijd het regenereren van een code op elke bezoek aan een onveranderd pagina: bewaar en hergebruik de bestand. Respect request limits and the Retry-After delay.
Wat te controleren vóór het publiceren
De API valideren input maar decodeert niet het eindige beeld. Dit vermindert de verwerking, maar uw werkstroom moet scan testen beheren. Test typische ontwerpcombinaties en de grootste gegevensvolumes die u verwacht.
Laat een licht stilte zone van ten minste vier modules, goed contrast en voldoende grootte. Scan de laatste gedrukte layout met een telefoon. De API-pagina bevat technische parameters en voorbereide voorbeelden van PHP, JavaScript, Python en cURL.
Bronnen en verder lezen
Voorbereid en gehandhaafd door Umind. Test deze aanbevelingen op uw uiteindelijke layout en doeltreffende apparaten.