מידע למפתחים - שירות WebService לשליחת פקס
להלן הוראות שימוש ב WS.
כללי : יש לפנות בממשק SOAP לכתובת השירות, להעביר פרמטרים שמגדירים את הפקס כמו נמענים וזמן משלוח, ולהעביר את הקבצים מקודדים ב Base64. השירות מחזיר סטרינג לזיהוי העבודה באורך 32Bytes, או קוד שגיאה מספרי וטקסטואלי. אפשר להצפין את התקשורת ע"י פנייה ל https.
כתובת השירות היא
http://www.freefax.co.il/ws/ws2.wsdl
יש לפנות לפונקציה SendFax לפי הדוגמה הבאה (הדוגמה ב PHP)
$client->SendFax("username,password,send,031234567,now,setlowpriority,
email@gmail.com,title text,$file");
להלן פירוט הפרמטרים :
$client->SendFax("A,B,C,D,E,F,G,H,I,J.....");
פרמטר A : שם המשתמש כפי שרשום אצל פריפקס.
פרמטר B : סיסמה כפי שרשומה אצל פריפקס.
פרמטר C : סטרינג קבוע, המילה send.
פרמטר D : רשימת מספרי טלפון לשליחת הפקס, ספרות בלבד, להפריד בין מספרים עם פסיק נקודה (;) עד 5000 מספרים.
פרמטר E : שעת המשלוח הרצוייה, יכול להיות ריק או now או after1900 או weekend.
פרמטר F : יכול להיות dontemailperfax כדי לא לקבל אישור פרטני במייל, או setlowpriority במקרה ושולחים פקסים רבים ברצף. אפשר להשאיר ריק, להפריד עם פסיק נקודה אם יותר מאחד.
פרמטר G : כתובת אימייל שתקבל אישור משלוח על הפקס. רצוי לא להשאיר ריק.
פרמטר H : טקסט חופשי לתיאור הפקס לצרכי מעקב. לא יופיע בפקס עצמו אלא באישור הפקס. עד 64 תווים.
פרמטר I והלאה : קבצים מקודדים כ Base64, קבצי ZIP ואחרים. אפשר לשלוח קבצים שסך גודלם עד 10MB.
את רשימת סוגי הקבצים הנתמכים אפשר לראות כאן
טבלת קודי שגיאה
1.File(s) too large.
2.No numbers.
3.Error is some numbers.
4.No files.
5.Error in some files. / some content of unknown type. Aborting fax.
6.user / password problem.
7.Title problem, it might be too long.