Qivo praktiske vejledninger
Hvordan en QR Code Generation API virker
En API giver dig mulighed for automatisk at generere QR-koder fra din hjemmeside, intern værktøj eller script.
Din ansøgning sender indhold og indstillinger; Qivo returnerer en statisk QR-billede.
Fra en manual til en integration
Med en API udfører et program disse handlinger, f.eks. ved at generere en produktside QR-kode mens du forbereder et tag.
En API-opkald gør ikke koden dynamisk. billedet gemmer de indsendte data i stedet for en mellemliggende Qivo URL. Du kan gemme og bruge filen uden at kontakte generatoren igen.
Hvad en anmodning indeholder
En GET-forespørgsel indeholder serviceadressen, parametre og en hemmelig nøgle. indholdType-parameteren vælger datatypen, formatet vælger PNG eller SVG, og form, grænse og center kontrollerer designet.
Parameter værdier skal være URL-kodet. Brug dit sprog standardværktøjer til korrekt at håndtere rum, + i telefonnummer og # i farver. Invalid eller manglende nødvendige felter forårsager en fejlrespons.
Hvorfor nøglen tilhører din server
Besøgende kan læse en nøgle placeret i en offentlig side JavaScript. Send forespørgsler fra din server og last nøglen fra en miljøvariabel.
Send nøglen i X-API-Key-hovedet over HTTPS. Den nøgle URL parameter er også understøttet, men URL'er kan vises i historie og loger. Aldri sætte din hemmelige nøgle i QR-billedet eller offentlige eksempler.
Hvordan man håndterer svaret
Et vellykket svar indeholder billedet selv, ikke JSON med en downloadlinke. Tjek HTTP-status før sparing. fejl returnerer JSON med en forklaring; gem ikke det som en PNG.
SVG er nyttigt for udskrivede materialer, mens PNG passer til daglige billeder. Undgå at genoprette en kode på hver besøg på en uændret side: gem og genanvende filen. Respektere begæringsgrænserne og Retry-After forsinkelse.
Hvad skal man tjekke inden udgivelsen
API validerer input, men dekoder ikke det færdige billede. Dette reducerer behandlingen, men dit arbejdsproces skal håndtere scanprøver. Tester typiske design kombinationer og de største data volumer du forventer.
Læg en lys stille zone af mindst fire moduler, god kontrast og tilstrækkelig størrelse. Scan den endelige trykte layout med en telefon. API-siden indeholder tekniske parametre og klar til brug PHP, JavaScript, Python og cURL eksempler.