通信方式

S系列IPPBX 和第三方应用服务器的通信是相互的, 双方互为服务端和客户端。

通信协议和端口

请求和响应

S系列IPPBX 支持使用 HTTPS 协议和 HTTP 协议进行 API 通信。

注: 为加强通信安全,我们建议你使用 HTTPS 协议,并上传专业证书机构制作的 HTTPS 证书到 PBX。
PBX 默认使用 HTTPS 网页访问协议,端口 8088,且启用 80端口重定向,你可以选择 HTTPS (端口 8088)或 HTTP(端口80)协议进行 API 通信。

外网 HTTP 通信

在中国,如果你要通过外网连接第三方服务器 和 PBX API,80 端口无法使用,需要备案信息。你可以更改 PBX 设置,使用其他端口。

登录 PBX 网页,进入 配置 > 系统 > 安全中心 > 服务, 选择 网络访问协议HTTP,将默认的 80 端口改为其他端口。

API 报告推送
PBX 主动向第三方服务器 推送 API 报告使用 HTTP 协议。

通信方式

S系列IPPBX 支持两种 API 通信方式。

1. 应用服务器向 PBX 发送请求

应用服务器为客户端,PBX 为服务端。应用场景:应用服务器向 PBX 发起呼叫、查询。

2. PBX 主动向服务器推送消息
前提条件:应用服务器需通过 PBX API 的验证,和 PBX API 建立连接。

应用服务器作为服务端,PBX 为客户端。

注: 第三方服务器接收到报告后,必须回复 200 OK 给 PBX, 否则 PBX 重复发送报告。