Використовуйте HTTPS і базову автентифікацію HTTP із затвердженими обліковими даними API. Зберігайте облікові дані на сервері вашого застосунку. Ці кінцеві точки Hosted 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 | Посилання на документ, яке очікує цей процес роботи з факсами; це не довільний шлях до локального файлу. |
Відстеження завершення
Після надсилання перевірте статус запису факсу, кількість спроб і помилку. Підтверджуйте доставку, а не вважайте прийняття доставкою. Довідник із факсів у порталі описує його поточний процес завантаження й надсилання; його шляхи та автентифікація окремі від кінцевої точки, наведеної вище.