Qivo Käytännön opas
Miten QR Code Generation API toimii
API antaa sinulle mahdollisuuden tuottaa QR-koodeja automaattisesti verkkosivustolta, sisäisestä työkalusta tai skripti.
Sovelluksesi lähettää sisältöä ja asetuksia; Qivo palauttaa staattisen QR-kuvan. salainen avain pysyy palvelimellasi.
Manuaalisesta toimittajasta integraatioon
Toimituksessa henkilö täyttää kentät ja klikkaa latausta. API: n avulla ohjelma suorittaa nämä toimet, esimerkiksi tuottaa QR-koodin tuotteen sivulle valmistellessaan merkkiä.
API-puhelu ei tee koodista dynaamista. kuva tallentaa lähetetyt tiedot sen sijaan, että väliaikainen Qivo URL. Voit tallentaa ja käyttää tiedostoa ottamatta yhteyttä tuottajaan uudelleen.
Mitä pyyntö sisältää
GET-pyyntö sisältää palvelun osoitteen, parametrit ja salaisen avaimen. SisältöTyypin parametri valitsee tietotyypin, muoto valitsee PNG tai SVG ja muoto, raja ja keskus hallitsevat suunnittelua.
Parametrien arvojen on oltava URL-koodattuja. Käytä kielesi vakiovälineitä hallitsemaan tiloja, + puhelinnumeroissa ja # väreissä oikein. Vaikutteiset tai puuttuvat tarvittavat kentät aiheuttavat virheen vastauksen.
Miksi avain kuuluu palvelimellesi
Avain antaa pääsyn sukupolveen.Vierailijat voivat lukea avaimen, joka on sijoitettu julkiselle sivulle JavaScript. Lähetä pyynnöt palvelimelta ja ladata avaimen ympäristömuutoksesta.
Lähetä avain X-API-Key -päällikön kautta HTTPS. Avain URL-parametri on myös tuettu, mutta URL-osoitteet voivat näkyä historiassa ja arkistoissa. Älä koskaan laita salaista avainta QR-kuvassa tai julkisissa esimerkissä.
Kuinka käsitellä vastausta
Menestyksekäs vastaus sisältää kuvan itsensä, ei JSON: n latausliittymällä. Tarkista HTTP-tilan ennen säästöä. Virheet palaavat JSON: n selityksen kanssa; älä säästä sitä PNG: n muodossa.
SVG on hyödyllinen tulostettuihin materiaaleihin, kun taas PNG soveltuu päivittäisiin kuvia. Vältä koodin uudelleenkäynnistä jokaisella vierailulla muuttumattomalle sivulle: tallentaa ja käyttää tiedostoa uudelleen. Noudata pyyntörajoituksia ja Retry-After viivästystä.
Mitä tarkistaa ennen julkaisemista
API vahvistaa sisäänkäynnin, mutta ei dekodeeraa valmiita kuvia. Tämä vähentää käsittelyä, mutta työnkulun on käsiteltävä skannatestiä. Testata tyypillisiä suunnittelukombinaatioita ja suurimpia tiedon määrää odotat.
Jätä kevyt hiljainen alue vähintään neljä moduulia, hyvä kontrasti ja riittävä koko. Skannata lopullinen tulostettu järjestelmä puhelimella. API-sivulla on teknisiä parametreja ja käytettäväksi valmis PHP, JavaScript, Python ja cURL esimerkkejä.
Lähteet ja lisää lukemista
Valmistettu ja ylläpidetty Umind. Testaa nämä suositukset lopullisessa asetuksessa ja kohdelaitteissa.