გამოიყენეთ HTTPS და HTTP Basic ავთენტიფიკაცია დამტკიცებული API-ს წვდომის მონაცემებით. წვდომის მონაცემები შეინახეთ თქვენს აპლიკაციის სერვერზე. ჰოსტინგზე განთავსებული PBX-ის ეს საბოლოო წერტილები იყენებენ /hpbx/-ს api.multitel.net-ზე; ნუ ჩასვამთ /v3-ს. შეამოწმეთ როგორც HTTP შედეგი, ისე აპლიკაციის სტატუსი JSON პასუხში.
ფაქსის ჩანაწერების წაკითხვა
curl --request POST --user "USERNAME:PASSWORD" \
"https://api.multitel.net/hpbx/fax/list/YOUR_BILLING_CODE"გამოიყენეთ თქვენი PBX-ის ბილინგის კოდი. დაბრუნებული ჩანაწერები მოიცავს ფაქსის დროს, მიმართულებას, წყაროს, დანიშნულებას, მიწოდების სტატუსს, მცდელობებს, შეცდომებსა და გვერდების რაოდენობას. გაგზავნის მოთხოვნის მიღების შემდეგაც მიწოდება შეიძლება მოლოდინში იყოს.
გაგზავნის პარამეტრები
გაგზავნის საბოლოო წერტილია POST /hpbx/fax/send/{billing_code}. ეს მოქმედება ფაილს რეალურად აგზავნის. წარდგენამდე მოამზადეთ ფაილი და ანგარიშისთვის ნებადართული დანიშნულება; თუ წინა გაგზავნის შედეგი გაურკვეველია, შემოწმების გარეშე ხელახლა ნუ გააგზავნით.
| ველი | მნიშვნელობა |
|---|---|
| number | დანიშნულების ფაქსის ნომერი. |
| cidnum | გაგზავნისთვის დამტკიცებული დამრეკავის იდენტიფიკატორი. |
| schedule | დაგეგმილი გაგზავნის დრო, თუ გამოიყენება. |
| faxquality / pagesize / pagerotate | მხარდაჭერილი ხარისხის, ქაღალდის ზომისა და როტაციის პარამეტრები. |
| statusemail | ავტორიზებული მისამართი მიწოდების შეტყობინებებისთვის. |
| deleteaftersend | უნდა წაიშალოს თუ არა ატვირთული და შენახული ფაილი გაგზავნის შემდეგ. |
| filename | დოკუმენტის მითითება, რომელსაც ფაქსის ეს სამუშაო პროცესი ელის; არა ლოკალური ფაილის თვითნებური გზა. |
დასრულების თვალყურის დევნება
გაგზავნის მოთხოვნის წარდგენის შემდეგ შეამოწმეთ ფაქსის ჩანაწერის სტატუსი, მცდელობები და შეცდომა. დაადასტურეთ ფაქტობრივი მიწოდება; მოთხოვნის მიღება მიწოდების დადასტურებად არ ჩათვალოთ. პორტალის ფაქსის სახელმძღვანელო აღწერს ატვირთვისა და გაგზავნის მიმდინარე პროცესს; მისი მისამართები და ავთენტიფიკაცია ზემოთ მოცემული API-ის წერტილისგან განცალკევებულია.