Qivo praktiska guider
Hur en QR Code Generation API fungerar
En API låter dig generera QR-koder automatiskt från din webbplats, interna verktyg eller skript.
Din ansökan skickar innehåll och inställningar; Qivo returnerar en statisk QR-bild.
Från en manuell redaktör till en integration
I redaktören fyller en person i fälten och klickar på nedladdning. med en API utför ett program dessa åtgärder, till exempel genom att generera en produktsida QR-kod medan du förbereder en etikett.
En API-samtal gör inte koden dynamisk. bilden lagrar de inlämnade uppgifterna istället för en Qivo-URL. Du kan spara och använda filen utan att kontakta generatorn igen.
Vad en begäran innehåller
En GET-förfrågan innehåller tjänsteadressen, parametrarna och en hemlig nyckel. innehållType-parameter väljer datatypen, formatet väljer PNG eller SVG, och form, gräns och centrum kontrollerar designen.
Parametervärden måste vara URL-kodade. Använd språkets standardverktyg för att korrekt hantera utrymmen, + i telefonnummer och # i färger. Invaliderade eller saknade nödvändiga fält orsakar ett fel svar.
Varför nyckeln hör till din server
Nyckeln ger tillgång till generering.Visa besökare kan läsa en nyckel som placeras i en offentlig sida JavaScript.Sänd förfrågningar från din server och ladda nyckeln från en miljövariabel.
Skicka nyckeln i X-API-nyckeln över HTTPS. NyckelURL parameter stöds också, men URL-adresser kan visas i historia och loggar. Sluta inte sätta din hemliga nyckel i QR-bild eller offentliga exempel.
Hur man hanterar svaret
Ett framgångsrikt svar innehåller bilden själv, inte JSON med en nedladdnings länk. Kontrollera HTTP-status innan du sparar. Fel returnerar JSON med en förklaring; Spara inte det som en PNG.
SVG är användbar för tryckta material, medan PNG passar vardagliga bilder. Undvik att regenerera en kod vid varje besök på en oförändrad sida: spara och återanvända filen. Respektera begäran gränser och Retry-After försening.
Vad ska man kolla innan man publicerar
API validerar input men dekoderar inte den färdiga bilden. Detta minskar bearbetningen, men din arbetsflöde måste hantera scanprovningar. Test typiska designkombinationer och de största datavolymerna du förväntar dig.
Lämna en lätt tyst zon av minst fyra moduler, bra kontrast och tillräcklig storlek. Skanna den slutliga tryckta layouten med en telefon. API-sidan innehåller tekniska parametrar och redo för användning PHP, JavaScript, Python och cURL exempel.
Källor och vidare läsning
Förberedd och underhålls av Umind. Testa dessa rekommendationer på din slutliga layout och måldatorer.