Ghidul practic al Qivo
Cum funcționează API-ul de generare a codului QR
O API vă permite să generați coduri QR automat de pe site-ul dvs., un instrument intern sau un script.
Aplicația dvs. trimite conținut și setări; Qivo returnează o imagine QR statică. cheia secretă rămâne pe serverul dvs.
De la un editor manual la o integrare
În editor, o persoană umple câmpurile și face clic pe descărcare. cu o API, un program efectuează aceste acțiuni, de exemplu, generând un cod QR al paginii produsului în timp ce pregătește o etichetă.
Un apel API nu face codul dinamic. imaginea stocă datele transmise în loc de un URL Qivo intermediar. puteți salva și utiliza fișierul fără a contacta din nou generatorul.
Ce conține o cerere
O cerere GET conține adresa de serviciu, parametrii și o cheie secretă. conținutulTipul parametrului selectează tipul de date, formatul selectează PNG sau SVG, și forma, frontiera și centrul de control al designului. textul plain necesită câmpul de date.
Valorile parametrilor trebuie să fie codate prin URL. Utilizați instrumentele standard ale limbii dvs. pentru a gestiona corect spațiile, numărul + în numere de telefon și numărul # în culori. Câmpurile invalide sau lipsite cauzează o răspuns greșită.
De ce cheia aparține serverului tău
Cheia oferă acces la generație.Vizitorii pot citi o cheie plasată în JavaScript-ul unei pagini publice.Să trimiteți cereri de pe serverul dvs. și să încărcați cheia dintr-o variabilă de mediu.
Trimiteți cheia în titlul de cheie X-API prin HTTPS. Parametrul URL-ului cheie este, de asemenea, susținut, dar URL-urile pot apărea în istorie și în jurnal. Nu puneți niciodată cheia ta secretă în imaginea QR sau exemplele publice.
Cum să gestionați răspunsul
Un răspuns de succes conține imaginea însăși, nu JSON cu un link de descărcare. verificați starea HTTP înainte de a salva. Erorile returnă JSON cu o explicație; nu salvați acest lucru ca un PNG.
SVG este util pentru materialele imprimate, în timp ce PNG se potrivește cu imaginile de zi cu zi. Evitați regenerarea unui cod la fiecare vizită la o pagină nemodificată: salvați și reutilizați fișierul. Respectați limitele cererii și retragerea ulterioară.
Ce trebuie verificat înainte de publicare
API validă intrarea, dar nu decodează imaginea terminată. Acest lucru reduce procesarea, dar fluxul de lucru trebuie să se ocupe de testarea scanului.
Lăsați o zonă liniștită ușoară de cel puțin patru module, un contrast bun și o dimensiune suficientă. Scanarea layoutului final imprimat cu un telefon. Pagina API conține parametri tehnici și exemple pregătite pentru utilizare PHP, JavaScript, Python și cURL.
Sursele și citirea ulterioară
Pregătit și menținut de Umind. testează aceste recomandări pe layout-ul final și dispozitivele țintă.