Qivo praktiske guider
Hvordan en QR-kode generering API fungerer
En API lar deg generere QR-koder automatisk fra nettstedet ditt, det interne verktøyet eller skriptet.
Applikasjonen sender innhold og innstillinger; Qivo returnerer en statisk QR-bilde.
Fra en manuell redaktør til en integrasjon
Med en API utfører et program disse handlingene, for eksempel generere en produktside QR-kode mens du lager et etikett.
En API-samtale gjør ikke koden dynamisk. bildet lagrer de innsendte dataene i stedet for en mellomliggende Qivo URL. Du kan lagre og bruke filen uten å kontakte generatoren igjen.
Hva en forespørsel inneholder
En GET-forespørsel inneholder tjenestadressen, parametrene og en hemmelig nøkkel. innholdtypeparameteren velger datatypen, formatet velger PNG eller SVG, og form, grense og senter kontrollerer utformingen.
Parameterverdier må være URL-kodet. Bruk språkets standardverktøy for å håndtere plassene, + i telefonnummer og # i farger. Invalid eller manglende nødvendige felt forårsaker en feilrespons.
Hvorfor nøkkelen tilhører serveren din
Nøkkelen gir tilgang til generasjon.Visitorer kan lese en nøkkel plassert i en offentlig JavaScript-side.Send forespørsler fra serveren din og last nøkkelen fra en miljøvariabel.
Send nøkkelen i X-API-nøkkelhovedet over HTTPS. URL-parameteren er også støttet, men URL-er kan vises i historie og logger. Aldri sette hemmelig nøkkel i QR-bilde eller offentlige eksempler.
Hvordan håndtere svaret
Et vellykket svar inneholder bildet selv, ikke JSON med en nedlastingslink. sjekk HTTP-status før du sparer. feil returnerer JSON med en forklaring; ikke sparer det som en PNG.
SVG er nyttig for utskriftsmaterialer, mens PNG passer til daglige bilder. Unngå å gjenopprette en kode på hvert besøk til en uendret side: lagre og gjenbruk filen. Respekt begjæringsgrenser og Retry-After forsinkelse.
Hva å sjekke før publisering
API validerer inntaket, men dekrypterer ikke den ferdige bildet. Dette reduserer behandlingen, men arbeidsflyten din må håndtere skannesting. Test typiske designkombinasjoner og de største datavolumene du forventer.
La en lys stille sone av minst fire moduler, god kontrast og tilstrekkelig størrelse. Skanne den endelige utskriftsløsningen med en telefon. API-siden inneholder tekniske parametere og klare for bruk PHP, JavaScript, Python og cURL eksempler.
Kilder og videre lesing
Forberedt og vedlikeholdt av Umind. Test disse anbefalingene på din endelige layout og mål-enheter.