Praktische Qivo-Anleitungen
Wie eine QR-Code-Generation API funktioniert
Eine API ermöglicht es Ihnen, QR-Codes automatisch von Ihrer Website, inneren Tools oder Skripten zu generieren.
Ihre Anwendung sendet Inhalte und Einstellungen; Qivo gibt eine statische QR-Immagung zurück.
Von einem Manual-Editor zu einer Integration
In der Editor füllt eine Person Felder und klickt auf Download. Mit einer API führt ein Programm diese Aktionen durch, z. B. Erzeugt eine Produktseite QR-Code während der Vorbereitung einer Etikette.
Ein API-Anruf macht den Code nicht dynamisch. Die Bild speichert die eingereichten Daten anstatt eine Qivo-URL. Sie können die Datei speichern und verwenden, ohne wieder mit dem Generator in Verbindung zu treten.
Was eine Anfrage enthält
Eine GET-Anfrage enthält die Service-Adresse, Parameter und einen geheimen Schlüssel. Der ContentType-Parameter wählt den Datentyp aus, Format wählt PNG oder SVG und Form, Grenze und Zentrum kontrolliert das Design.
Die Parameterwerte müssen URL-Coded sein. Verwenden Sie die Standard-Tools Ihrer Sprache, um Räume, die + in Telefonnummern und die # in Farben richtig zu verwalten. Invalid oder fehlende erforderliche Felder verursachen eine Fehlerantworten.
Warum der Schlüssel auf Ihrem Server gehört
Die Schlüssel ermöglicht den Zugriff auf Generation. Besucher können einen Schlüssel lesen, der in eine öffentliche JavaScript-Seite platziert ist. Senden Sie Anfragen von Ihrem Server und laden Sie den Schlüssel von einer Umweltvariablen herunter.
Senden Sie den Schlüssel in der X-API-Schlüsselheader über HTTPS. Der SchlüsselURL-Parameter wird auch unterstützt, aber URLs können in Geschichte und Logs erscheinen.
Wie man mit der Antwort umgehen kann
Eine erfolgreiche Antwort enthält das Bild selbst, nicht JSON mit einem Download-Link. Prüfen Sie den HTTP-Status vor der Speicherung. Fehler geben JSON mit einer Erklärung zurück; speichern Sie das nicht als PNG.
SVG ist nützlich für gedruckte Materialien, während PNG die täglichen Bilder entspricht. Vermeiden Sie die Regeneration eines Codes bei jedem Besuch einer unveränderten Seite: Speichern und erneut verwenden Sie die Datei. Respektieren Sie die Forderungsgrenze und die Retry-After Verzögerung.
Was Sie vor der Veröffentlichung überprüfen müssen
Die API validiert die Eingabe, aber dekodiert nicht das fertige Bild.Dies reduziert die Verarbeitung, aber Ihr Workflow muss Scan-Tests verwalten.Test typische Designkombinationen und die größten Datenvolumen, die Sie erwarten.
Lassen Sie eine leichte ruhige Zone von mindestens vier Modulen, gutem Kontrast und ausreichender Größe. Scannen Sie die endgültige gedruckte Layout mit einem Telefon. Die API-Seite enthält technische Parameter und bereit für den Einsatz PHP, JavaScript, Python und cURL Beispiele.
Quellen und weitere Informationen
Erstellt und betreut von Umind. Empfehlungen am fertigen Layout und auf den Zielgeräten testen.