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

השינויים ב-API הציבורי של Pristo, מהחדש לישן: נקודות קצה, אימות, שדות בבקשה ותשובות שגיאה, והגרסה שבה יצא כל שינוי.

בדף הזה מופיעים השינויים ב-API של Pristo שמשפיעים על האינטגרציה שלכם, מהחדש לישן. [תיעוד ה-API (באנגלית)](https://docs.pristo.io/cx/api/reference) מתאר תמיד את ה-API הנוכחי; הדף הזה מסביר מה השתנה ומתי.

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

## 21 באוקטובר 2026

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

- כתובת הבסיס היא `https://api.pristo.io`.
- יוצרים מפתחות API במערכת Pristo CX. ראו [אימות באמצעות מפתח API](https://docs.pristo.io/he/cx/api/authentication).
- ל-API יש שתי פעולות: [שליחת אירוע](https://docs.pristo.io/he/cx/api/send-an-event) ו[יצירת קישור לסקר](https://docs.pristo.io/he/cx/api/generate-a-survey-link). אין נקודת קצה ששומרת או קוראת אנשי קשר או משובים.
- השדה `language` של קישור לסקר קובע רק את השפה של דף התפוגה ושל דף התודה של הקישור. השאלון נפתח בשפה הראשית שלו.
- מפתח API חסר או לא מוכר מחזיר `401` עם גוף JSON מסוג problem. שאר השגיאות מפורטות בדף [שגיאות API](https://docs.pristo.io/he/cx/api/errors).

## 23 באוגוסט 2026

- כל מפתח API שייך לתוכנית אחת: התוכנית שהייתה פעילה ב-Pristo CX כשהמפתח נוצר. מפתחות שנוצרו לפני כן שויכו לתוכנית הראשונה בחשבון.
- נקודת הקצה `POST /v1/events/send` מוצאת את האוכלוסייה לפי התוכנית של המפתח. הנתיב הישן `POST /v1/events/send/{popId}` עדיין עובד ועושה אותו דבר, והמערכת מתעלמת מה-`popId` שלו. בקוד חדש השתמשו ב-`/v1/events/send`.

## 3 עד 6 באוגוסט 2026

- גישה ל-API כלולה בחבילה הסטנדרטית ובחבילת פרימיום. יצירה, הפעלה ושינוי שם של מפתח בחבילה אחרת מחזירים `403`. השבתה ומחיקה של מפתח עובדות תמיד.
- בחשבון יכולים להיות עד 10 מפתחות API פעילים.
- מפתחות שנוצרו לפני הכלל הזה בחבילה בלי גישה ל-API בוטלו.

## ראו גם

- [סקירה כללית של ה-API של Pristo](https://docs.pristo.io/he/cx/api)
- [אימות באמצעות מפתח API](https://docs.pristo.io/he/cx/api/authentication)
- [שגיאות API](https://docs.pristo.io/he/cx/api/errors)