פרוטוקול משימות
שליחת הודעה
שליחת הודעה למספר יחיד או מספרי נייד מרובים, username@ או #groupcode#.
פרמטרים | שם או תיאור |
---|---|
Operation | Pv |
Mandatory | u h to msg |
Optional | הקלד unicode מתבנית footer nofooter |
Returns | מחזיר קודים |
הפרמטר "to" יכול להיות מספר נייד בקידוד בינלאומי
SMS יוצא וסטטוס מסירה
פרמטרים | שם או תיאור |
---|---|
Operation | Ds |
Mandatory | u h |
Optional | queue src dst dt smslog_id c last format |
Returns | מחזיר מידע או קודים |
הפרמטר c יאחזר מספר פעמים כהערך c, האחרון יאחזר מידע מהSMS LOG ID האחרון
SMS נכנס
פרמטרים | שם או תיאור |
---|---|
Operation | In |
Mandatory | u h |
Optional | queue src dst dt smslog_id c last format |
Returns | מחזיר מידע או קודים |
הפרמטר c יאחזר מספר פעמים כהערך c, האחרון יאחזר מידע מהSMS LOG ID האחרון
User credit
שליפת מידע אודות האשראי של המשתמש
פרמטרים | שם או תיאור |
---|---|
Operation | Cr |
Mandatory | u h |
Optional | Format |
Returns | מחזיר אשראי של המשתמש או קודים |
Get token
שליפת טוקן webservices של המשתמש. יכול לשמש כמנגנון התחברות.
פרמטרים | שם או תיאור |
---|---|
Operation | get_token |
Mandatory | u p |
Optional | Format |
Returns | מחזיר טוקן webservices או קודים |
Set token
קביעת טוקן webservices של המשתמש. יכול לשמש כמנגנון שינוי סיסמא.
פרמטרים | שם או תיאור |
---|---|
Operation | set_token |
Mandatory | u h |
Optional | Format |
Returns | מחזיר טוקן webservices חדש או קודים |
התחברות Webservices
אימות משתמש באמצעות webservices והפניה לindex.php עם האימות, מוצלח, נכשל או לא תקין.
פרמטרים | שם או תיאור |
---|---|
Operation | ws_login |
Mandatory | u login_key |
Optional | None |
Returns | אין החזרות, הפניה ל- index.php |
הפרמטר login_key מוגדר על ידי חשבונות אדמין דרך קריאת webservices בשימוש הפעולה loginkeyset
JSON HTTPS
חייב להיות שימוש ב HTTPS במקום HTTP.
ה-URL הבסיסי חייב להיות:
https://sms.voipe.co.il/playsms/api.php
כל הפרמטרים אמורים להיות מועברים כחלק מאובייקט JSON בגוף POST ולא ב-GET.
את הפרמטרים הבאים יש לשנות:
1. "user" במקום "u".
2. "token" במקום "h".
בשאר הפרמטרים של Playsms Webservice Api ניתן להשתמש כפי שהם מפורטים ב- http://sms.voipe.co.il/index.php?app=ws
Example of API call
POST /playsms/api.php HTTP/1.1 Host: sms.voipe.co.il
{"user":"vipuser","token":"1212121212121212121212121212","op":"pv","to":"052111222","msg":"Test message","from":"VipInvest"}'
Few notes field “from” must contain predefined value wich is set in our panel by our administrator - so this field must be discussed with our responsible person field “from” must be not more then 8 latin symbols
שליפת אשראי חשבון
פרמטרים | שם או תיאור |
---|---|
Operation | creditview |
Mandatory | u h data_username |
Optional | Format |
Returns | מחזיר קודים ויתרה |