מדריך | אם גם אתה לא יודע API (כמוני...), כדאי לך לקרוא את זה!! מדריך פשוט וקל מה בל זאת תוכלו להוציא מהAPI של ימות המשיח (ולא רק...), דברים מדהימים!

[צבי דורש ציון]

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

נתחיל קודם בפקודות מהדפדפן, בהמשך נראה גם איך אפשר לעשות את כל מה שיש באתר הניהול - דרך הטלפון.
זה אולי נשמע לא כל כך נצרך, אבל האמת שעם קצת יצירתיות והתרגלות, אפשר לעשות עם זה כ50% ממה שהמתכנתים פה עושים! (מנסיון) זה אולי בצורה קצת יותר מורכבת, עם קצת 'קומבינות', אבל התוצאה אותו דבר.

אז כמו שאמרנו, נתחיל בפקודות מהדפדפן, איך יוצרים פקודות מהדפדפן? ממש פשוט וקל!

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

https://www.call2all.co.il/ym/api/

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

CreateTemplate

אז נוסיף את זה לקישור הקודם.

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

token

ואז שמים "="
דהיינו מהו הטוקן, ואז צריך למלאות את הפרמטר, דהיינו את מספר המערכת והסיסמה, כותבים את זה ככה 0773333333:1234, דהיינו מספר מערכת נקודותיים סיסמה.

עכשיו אנו צריכים למלאות פרמטר נוסף, "שם הקמפיין"
אז נוסיף את הסימן הזה & ואז נכתוב את שם הפרמטר הנוסף כפי שמופיע שם בתיעוד

description

ושוב, שווה (=) ואת שם הקמפיין

וזהו, בזה סיימנו את הפקודה, ואנחנו יכולים להריץ אותה בדפדפן!
זה אמור להיראות כך

https://www.call2all.co.il/ym/api/CreateTemplate?token=0773333333:1234&description=שם הקמפיין

עד כאן לפקודות מהדפדפן (או משרת וכדו')

---

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

type=api

לאחר מכן נכתוב בשורה הבאה

api_link=

ולאחר השוה את הכתובת לשליחת הפניה, דהיינו השרת של ימות, עם הפקודה הרצויה
זה יראה כך:

api_link=https://www.call2all.co.il/ym/api/CreateTemplate

לאחר מכן צריך לכתוב בשורות הבאות את ה'פרמטרים', לזה צריך לכל פרמטר שורה שמתחילה כך

api_add_0=

ולאחר השוה את שם הפרמטר=את הפרמטר עצמו.
גם בכל פרמטר נוסף צריך לכתוב את המספר הבא בתחילת השורה (בדוגמא מקודם כתוב 0, בפרמטר הבא צריך שזה יהי' 1)
ובדוגמא שלנו זה יראה כך

api_add_0=token=0773333333:1234
api_add_1=description=שם הקמפיין

וזה ההגדרה לאן יועבר בסיום

api_end_goto=/

צריך להשתיק את הודעה M1607 "אין מענה משרת API"

עד כאן זה איך לעשות את זה כשלוחה דרך הטלפון

---

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

---

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

ניתן לראות כאן דוגמאות לפקודות מהדפדפן, זה יכול אולי לעזור למי שלא לגמרי הבין את המדריך.

כמובן שאשמח מאד להערות והארות.