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

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

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

כיצד ניתן לקבל Token עבור ממשק ה-API?
לחיצה על גלגל השיניים האפור בפינה השמאלית > לחיצה על ממשקי אינטרנט בתפריט מימין >> בתחילת הדף נראה את ה- 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.

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

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

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