דלגו לתוכן

יומן שינויים של ה-API

בדף הזה מופיעים השינויים ב-API של Pristo שמשפיעים על האינטגרציה שלכם, מהחדש לישן. תיעוד ה-API (באנגלית) מתאר תמיד את ה-API הנוכחי; הדף הזה מסביר מה השתנה ומתי.

ל-API יש גרסה אחת, v1, בכתובת https://api.pristo.io. בשינוי שהיה שובר קריאות קיימות, ההתנהגות הקודמת ממשיכה לעבוד, והשינוי מופיע קודם כול בדף הזה.

תיעוד ה-API באתר הזה מחליף את דפי המפתחים הישנים. הוא מתאר את ה-API כפי שיצא ב-11 באוקטובר 2026. אם פיתחתם לפי הדפים הישנים, בדקו את ההבדלים האלה:

  • כתובת הבסיס היא https://api.pristo.io.
  • יוצרים מפתחות API במערכת Pristo CX. ראו אימות באמצעות מפתח API.
  • ל-API יש שתי פעולות: שליחת אירוע ויצירת קישור לסקר. אין נקודת קצה ששומרת או קוראת אנשי קשר או משובים.
  • השדה language של קישור לסקר קובע רק את השפה של דף התפוגה ושל דף התודה של הקישור. השאלון נפתח בשפה הראשית שלו.
  • מפתח API חסר או לא מוכר מחזיר 401 עם גוף JSON מסוג problem. שאר השגיאות מפורטות בדף שגיאות API.
  • כל מפתח API שייך לתוכנית אחת: התוכנית שהייתה פעילה ב-Pristo CX כשהמפתח נוצר. מפתחות שנוצרו לפני כן שויכו לתוכנית הראשונה בחשבון.
  • נקודת הקצה POST /v1/events/send מוצאת את האוכלוסייה לפי התוכנית של המפתח. הנתיב הישן POST /v1/events/send/{popId} עדיין עובד ועושה אותו דבר, והמערכת מתעלמת מה-popId שלו. בקוד חדש השתמשו ב-/v1/events/send.
  • גישה ל-API כלולה בחבילה הסטנדרטית ובחבילת פרימיום. יצירה, הפעלה ושינוי שם של מפתח בחבילה אחרת מחזירים 403. השבתה ומחיקה של מפתח עובדות תמיד.
  • בחשבון יכולים להיות עד 10 מפתחות API פעילים.
  • מפתחות שנוצרו לפני הכלל הזה בחבילה בלי גישה ל-API בוטלו.