התחלת עבודה עם Rest API

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

את הפעולות ניתן לבצע בעזרת שליחה וקבלת נתונים במבנה JSON ופנייה ל API בצירוף TokenID ייחודי של המערכת שלכם.

כיצד ניתן לקבל Token עבור ממשק ה-API?
לחיצה על גלגל השיניים האפור בפינה השמאלית > לחיצה על ממשקי אינטרנט בתפריט מימין >> בתחילת הדף נראה את ה- TokenID שלנו ובסוף הדף תחת רשימת משתמשים וטוקנים נראה את ה TokenID של שאר המשתמשים במערכת.

 

*לכל משתמש במערכת ישנו TokenID יחודי.

את הקריאות נוכל לבדוק בעזרת כלי המדמה קריאות HTTP לממשק ה API , בדוגמאות שלנו נשתמש ב
Postman שהינו תוסף לדפדפן Chrome וניתן להוריד אותו בחינם מחנות Chrome
בקישור הבא.

 

קריאות לממשק ניתן לבצע באמצעות קריאות HTTP בכל שפה שנרצה, לדוגמא:
PHP
Java script
#C

התהליך מתבצע בעזרת קריאה לכתובת URL לפי הפקודה שנרצה לבצע.

Action: Create

Method: POST

URL: https://api.powerlink.co.il/api/record/{record}

 

Action: Update

Method: PUT

URL: https://api.powerlink.co.il/api/record/{record}/{id}

 

Action: Delete

Method: DELETE

URL: https://api.powerlink.co.il/api/record/{record}/{id}

 

 

Action: Query

Method: POST

URL: https://api.powerlink.co.il/api/query

 

Action: Get

Method: GET

URL: https://api.powerlink.co.il/api/record/{record}/{id}

 

{record} משמעותו מספר הרשומה/שם המערכת של הרשומה.

{id} משמעותו מספר של רשומה ספציפית ממנו רוצים לקבל, לערוך או להוסיף ערכים.

ניתן ללחוץ על גלגל השיניים הגדול משמאל > בתפריט ההגדרות העליון יש לבחור ב"מנהל רשומות".

נוכל לראות עבור כל רשומה את שם המערכת שלה ואת המספר שלה.

איך נדע מה שם המערכת של האוביקט עליו נרצה לבצע פעולות?

נלחץ על גלגל השיניים האפור בפינה השמאלית > בתפריט מצד ימין נלחץ על "הגדרת רשומות", כעת נלחץ על האוביקט ובפרטים שלו נעתיק את השם תחת השדה "שם מערכת".

 

שמות מערכת של אוביקטים נפוצים:

לקוחות - שם הרשומה: account מספר הרשומה: 1 

קריאות שירות - שם הרשומה:cases מספר הרשומה: 5 

משימות - שם הרשומה: task מספר הרשומה: 10

כעת, לאחר שמצאנו את שם המערכת של האוביקט נוכל להחליף אותו בכתובת ה-URL במקום {record}. נעבור לתוכנת Postman שם נזין את כתובת ה URL.

 

הזנת POST

לכל פעולה יש מתודה שמתאימה לה, את המתודה נבחר דרך לחיצה על החץ ליד ה GET מצד שמאל.

 

לחיצה על GET

כעת יש להכניס את כתובת ה URL ונחליף את הפרמטרים עם שמות המערכת והמזהה של הרשומה.

נלחץ על "Headers" שם נזין את ה TokenID שהעתקנו מהמערכת תחת ממשקי אינטרנט. בשדה השמאלי במקום Key נרשום Tokenid, ובשדה הימיני במקום value נדביק את המזהה.

הזנת HEADER

לאחר מכן נלחץ על Body, נבחר את הפורמט של השאילתה' נסמן בעיגול את raw ונבחר (JSON (application/json.

 

בחירת פורמט השאילתא

 

למאמרים נוספים בנושא API:

שאילתא דרך API

יצירת רשומה חדשה

עדכון רשומה

מחיקת רשומה

כניסה ל-GitHub להסברים נוספים