תורגם בבינה מלאכותית. הקהילה עוד לא בדקה את התרגום. לקריאה באנגלית

בלוג · 10 באוקטובר 2023 · Steve Simpson · אינטגרציה

לרוחב ממשקי ה-API: סיכום ממשקי ה-API של Salesforce

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

מבוא לממשקי ה-API של Salesforce

ניווט בין ממשקי ה-API של Salesforce

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

הבנת האימות

לפני שצוללים לממשקי ה-API, חשוב להבין את תהליך האימות. כשדפדפן ניגש ל-Salesforce, הוא מתאמת מול שרת לפני שהוא מגיע לתוכן הפרטי. האימות הזה חיוני, בין אם אתם ניגשים לאתרים ציבוריים, לפורטלים של Experience, או אפילו לדפים ציבוריים של Web-to-Lead ו-Web-to-Case.

תרשים: גישה ל-Salesforce וממשקי API. אפליקציית לקוח ודפדפן מתאמתים דרך שרת האימות, ואז מגיעים לשירותי אינטרנט עם גרסאות (ממשקי ה-API הסטנדרטיים), לשירותי REST ו-SOAP מותאמים אישית ללא גרסאות, לאתרים ציבוריים, ל-Web-to-Lead ול-Email-to-Case

שרתי אינטרנט עם גרסאות וללא גרסאות

החשיבות של ניהול גרסאות

Salesforce משחררת ממשקי API תחת מספרי גרסה מוגדרים, ושומרת על היכולות והתאימות שלהם במשך שנים, עד שבסופו של דבר הם יוצאים משימוש (deprecated).

כצרכנים, אתם צריכים לדעת באיזו גרסה אתם משתמשים, ולהיות מוכנים לשדרג לגרסאות חדשות יותר (עם בדיקות).

ממשקי REST ו-SOAP API מותאמים אישית

עבור ממשקי REST או SOAP API מותאמים אישית שאתם יוצרים, Salesforce לא מספקת ניהול גרסאות. האחריות שלכם לנהל ולתחזק את הממשקים האלה, ולוודא שהם עובדים כמצופה בכל עדכון של Salesforce.

תרשים: ממשקי ה-API של Salesforce שלקוח חיצוני יכול לקרוא להם (SOAP, ‏REST, ‏Bulk, ‏Apex SOAP ו-REST, ‏Metadata, ‏Tooling, ‏Streaming ו-Pub/Sub) אחרי אימות דרך אפליקציה מחוברת ומשתמש אינטגרציה

אימות של לקוחות חיצוניים

כשלקוחות חיצוניים ניגשים ל-Salesforce, הם חייבים להתאמת דרך תהליכים מוגדרים. הלקוחות האלה יכולים להיות מסוגים שונים, כולל לקוחות SOAP שמשתמשים ב-Enterprise WSDL או ב-Partner WSDL, לקוחות REST, לקוחות Bulk API ורבים אחרים.

היכרות עם ממשקי API שונים

ל-Salesforce יש מגוון רחב של ממשקי API, שכל אחד מהם מתוכנן למשימות ולפונקציות מסוימות. מ-Salesforce Event Bus החדש ועד ממשקי API שמיועדים לתעשיות שונות כמו בריאות וייצור, יש API כמעט לכל צורך.

צילום מסך: הדף Browse APIs באתר Salesforce Developers, עם רשימת כרטיסים של ממשקי API

https://developer.salesforce.com/docs/apis (opens in a new tab)

כלים ומשאבים

Postman: החבר הכי טוב של המפתח

למפתחים שעובדים עם ממשקי ה-API של Salesforce, כלים כמו Postman הם יקרי ערך. Postman מאפשר לכם להריץ אימותים ושאילתות, ואפילו להוסיף, לערוך, לעדכן או למחוק נתונים מחוץ ל-Salesforce, ולכן הוא כלי חיוני לבדיקה ולפיתוח של ממשקי API.

צילום מסך: בקשה ב-Postman שמריצה שאילתת SOQL מול ה-REST API של Salesforce, עם כותרת ההרשאה ותגובת ה-JSON

שימוש בתיעוד ובאוספים

היכרות עם התיעוד הזמין היא המפתח לשליטה בממשקי ה-API של Salesforce. משאבים כמו REST API Developer Guide ואוספי Postman שונים שזמינים ב-GitHub יכולים להקל מאוד על תהליך הפיתוח שלכם.

סיכום:

הבנה ושימוש אפקטיבי בממשקי ה-API של Salesforce הם קריטיים לכל מפתח או ארכיטקט אינטגרציה שעובד עם Salesforce. עם מגוון רחב של ממשקי API וכלים לרשותכם, אתם יכולים לטפל בנתונים ובהגדרות בתוך Salesforce, לקרוא, לערוך ולעדכן אותם ביעילות.

אל תהססו לחקור, להתנסות ולשלב!

הישארו איתנו

צאו לדרך עם ממשקי ה-API של Salesforce בביטחון! לתובנות ולטיפים נוספים, הישארו איתנו כאן ב-www.SteveTechArc.com ובערוץ ה-YouTube ‏@SteveTechArc (opens in a new tab). הירשמו והעמיקו את ההבנה שלכם ב-Salesforce ובאופן שבו אפשר לשלב אותה עם מערכות אחרות.

עוזרים לשנות את העולם בשיתוף מידע על אינטגרציה עם עמיתים ארכיטקטים ועם מי שנמצאים במסע שלהם לארכיטקטורה!

תמלול בסיוע בינה מלאכותית

STA 1.9