השיטות האלה עוזרות לשמור על אינטגרציה אמינה ויעילה עם ה-API של אקטיב טרייל.
טיפול בשגיאות
בעיות חיבור ושגיאות יכולות לקרות בכל API. בדקו תמיד את התגובה לכל קריאה. אם קריאה נכשלת, תעדו אותה בכמה שיותר פרטים: מה שלחתם, תגובת השגיאה המלאה והכותרות (headers). כך הרבה יותר מהיר למצוא את הסיבה אם תצטרכו לפנות לתמיכה של אקטיב טרייל. ראו מילון שגיאות ה-API.
כשאפשר, הריצו קריאות API ברקע, במקום לגרום למשתמשים לחכות לתגובה. יוצא דופן אחד הוא טופס הרשמה מותאם, שבו אנשים בדרך כלל רוצים לדעת מיד אם ההרשמה הצליחה.
פחות קריאות, וממוקדות יותר
- בקשו רק את הנתונים שאתם צריכים.
- אל תבדקו נתונים בתדירות גבוהה מהנדרש. למשל, רוב הפתיחות וההקלקות של קמפיין קורות ב-24 השעות הראשונות אחרי השליחה, ולכן אין צורך לקרוא את נתוני הקמפיין כל שעה במשך ימים.
- סנכרנו רק נתונים חדשים או נתונים שהשתנו, ושמרו במטמון (cache) נתונים שמשתנים רק לעתים רחוקות.
שמירת ערכים במטמון
שמרו במטמון ערכים שאתם משתמשים בהם הרבה אבל שמשתנים לעתים רחוקות, כמו מזהים של קבוצות, קמפיינים ואוטומציות. אם יש לאינטגרציה שלכם אזור הגדרות, אפשרו למשתמשים לעדכן שם את הערכים האלה.
הגנה על מפתחות ה-API
- השתמשו ב-TLS (HTTPS) בכל קריאה.
- כשאפשר, הגבילו מפתחות לפי כתובת IP והגדירו להם תאריך תפוגה.
- תנו לכל מפתח או מערכת מפתח משלהם, כדי שתוכלו לנהל ולהשבית מפתחות בנפרד.
ראו מפתחות API.
איזון כמות הקריאות
השתמשו בחלוקה לעמודים במקום בהרבה קריאות לפריט בודד. למשל, מאות קריאות בשנייה כדי לקרוא 200 נמענים אחד אחד יכולות להיראות כמו שימוש לרעה. קראו אותם בעמודים במקום זאת. ראו מגבלות API וחלוקה לעמודים.