请使用 HTTPS 和 HTTP Basic 身份验证,并使用经批准的 API 凭据。请将凭据保存在您的应用服务器上。这些托管 PBX 端点在 api.multitel.net 上使用 /hpbx/;请勿插入 /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 | 此传真工作流程所需的文档引用；并非任意本地文件路径。 |
跟踪完成情况
提交后，请检查传真记录的状态、尝试次数和错误信息。请确认实际投递情况，而不要将受理视为投递。门户传真参考记录了其当前的上传和发送工作流程；其路径和身份验证与上述端点相互独立。