מדריכים מעשיים של Qivo
כיצד פועלת API ליצירת קוד QR
API מאפשר לך ליצור קודים QR באופן אוטומטי מהאתר שלך, כלי פנימי או סקריפט.
היישום שלך שולח תוכן והגדרות; Qivo מחזיר תמונה QR סטטית.
מתוך עורך מדריך לאינטגרציה
עם API, תוכנית מבצעת פעולות אלה, למשל, ליצור דף מוצר קוד QR בעת הכנת תווית.
שיחת API אינה עושה את הקוד דינמי.תמונה מאוחסנת את הנתונים שהוגשו במקום כתובת URL ביניים של Qivo.אתה יכול לשמור ולהשתמש בקובץ מבלי ליצור קשר עם הגנרטור שוב.
מה הבקשה מכילה
בקשה GET מכילה את כתובת השירות, פרמטרים ומפתח סודי.התוכןפרמטרים סוגים בוחרים את סוג הנתונים, פורמט בוחרים PNG או SVG, וצורה, גבול ומרכז בקרת העיצוב.טקסט שטוח דורש את שדה הנתונים.
ערכים פרמטרים חייבים להיות מוצפנים ב-URL. השתמש בכלים סטנדרטיים בשפה שלך כדי לנהל כראוי את החלל, את + במספר הטלפון ואת # בצבעים. שדות שאינם בתוקף או חסרים גורמים לתגובה שגיאה.
למה המפתח שייך לשרת שלך
המפתח מספק גישה ליצירה.מבקרים יכולים לקרוא מפתח הממוקם ב- JavaScript של דף ציבורי.שלח בקשות מהשרת שלך ולעלות את המפתח ממשתנה סביבתי.
שלח את המפתח בכותרת X-API-מפתח דרך HTTPS. גם תומך בפרמטרי ה-URL המפתח, אך ניתן להציג את ה-URL בהיסטוריה ובלימודים. לעולם אל תשים את המפתח הסודי שלך בתמונה QR או בדוגמאות ציבוריות.
כיצד להתמודד עם התגובה
התגובה המוצלחת מכילה את התמונה עצמה, לא JSON עם קישור להורדה.בדוק את מצב HTTP לפני שמירה.טעות חוזרת JSON עם הסבר; אל תשמור את זה כ- PNG.
SVG הוא שימושי עבור חומרים מודפסים, בעוד PNG מתאים תמונות יומיומיות. הימנעות מחדש קוד בכל ביקור בדף ללא שינוי: לשמור ולהשתמש מחדש בקובץ.
מה לבדוק לפני פרסום
ה- API מאשרת את הכניסה אך אינו מעודכן את התמונה הסופית.זה מפחית את עיבוד, אך זרימת העבודה שלך חייבת להתמודד עם בדיקות סריקה.
השאירו אזור שקט בהיר של לפחות ארבעה מודולים, ניגוד טוב וגודל מספיק.סריקת ההרצאה המדפסת הסופית עם טלפון.דף ה- API מכיל פרמטרים טכניים ודוגמאות מוכנות לשימוש של PHP, JavaScript, Python ו- cURL.