AXB模式呼叫事件通知接口
接口功能
隐私保护通话平台通过此接口向客户推送隐私保护通话用户呼叫时的状态信息，如呼入、呼出、振铃、应答、挂机等状态的信息。
请求方向
隐私保护通话平台（客户端） → 客户服务器（服务端）
使用说明
- 前提条件
客户添加应用时需设置呼叫状态接收地址，并确保提供的地址能够正常处理隐私保护通话平台发送的通知消息。
如果需要单独接收呼入事件（callin），需联系客服，提供呼入事件状态接收地址。
- 注意事项
若平台给客户推送呼叫事件通知后未收到成功响应，视为推送失败，平台会重新推送呼叫事件通知，直至客户返回成功响应。平台最多重推6次，分别于1分钟、4分钟、9分钟、106分钟、203分钟和300分钟后重推。
- 使用限制
接口类型
请求方法 |
POST |
|---|---|
访问URI |
客户添加应用时填写的呼叫状态接收地址 |
通信协议 |
HTTPS/HTTP |
请求参数
AXB模式中，A和B通过X号码形成绑定关系，使用隐私号码X互相通讯。
注：以下流程和接口示例以A拨打X，呼叫转接至B，B用户接听为例，流程和接口示例仅供参考，请以实际消息为准。
参数名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
eventType |
是 |
String(枚举) |
该参数标识通知的事件类型。 取值范围如下：
|
statusInfo |
否 |
CallStatusInfo |
呼叫状态事件的信息。 当eventType参数为callin、callout、alerting、answer、disconnect时携带。 |
参数名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
timestamp |
是 |
String(1-128) |
该呼叫事件发生时隐私保护通话平台的UNIX时间戳。 该参数取值为UTC时间（+8小时为北京时间）格式，即为“yyyy-MM-dd HH:mm:ss”。 |
sessionId |
是 |
String(1-256) |
唯一指定一条通话链路的标识ID。 |
caller |
否 |
String(1-32) |
主叫号码。 号码为全局号码格式（包含国家码），如+8613800000021。 注：呼入事件的主叫号码为A号码。 |
called |
否 |
String(1-32) |
被叫号码。 注：呼入事件的被叫号码为X号码。 |
subscriptionId |
否 |
String(1-64) |
绑定ID。 |
接口示例
POST /status HTTP/1.1
Content-Length: xx
{"eventType":"callin","statusInfo":{"sessionId":"1200_1029_4294967295_20190123091514@callenabler246.huaweicaas.com","timestamp":"2019-01-23 09:15:14","caller":"+8613800000021","called":"+8613800000022","subscriptionId":"e97b2863-e7ad-4b4c-87c0-91b0171fe803"}}
参数名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
timestamp |
是 |
String(1-128) |
该呼叫事件发生时隐私保护通话平台的UNIX时间戳。 该参数取值为UTC时间（+8小时为北京时间）格式，即为“yyyy-MM-dd HH:mm:ss”。 |
sessionId |
是 |
String(1-256) |
唯一指定一条通话链路的标识ID。 |
caller |
否 |
String(1-32) |
主叫号码。 号码为全局号码格式（包含国家码），如+8613800000021。 注：呼出事件的主叫号码为X号码。 |
called |
否 |
String(1-32) |
被叫号码。 注：呼出事件的被叫号码为B号码。 |
subscriptionId |
否 |
String(1-64) |
绑定ID。 |
接口示例
POST /status HTTP/1.1
content-length:xx
{"eventType":"callout","statusInfo":{"sessionId":"1200_1029_4294967295_20190123091514@callenabler246.huaweicaas.com","timestamp":"2019-01-23 09:15:15","caller":"+8613800000021","called":"+8613866887021","subscriptionId":"e97b2863-e7ad-4b4c-87c0-91b0171fe803"}}
参数名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
timestamp |
是 |
String(1-128) |
该呼叫事件发生时隐私保护通话平台的UNIX时间戳。 该参数取值为UTC时间（+8小时为北京时间）格式，即为“yyyy-MM-dd HH:mm:ss”。 |
sessionId |
是 |
String(1-256) |
唯一指定一条通话链路的标识ID。 |
caller |
否 |
String(1-32) |
主叫号码。 号码为全局号码格式（包含国家码），如+8613800000021。 注：振铃事件的主叫号码为X号码。 |
called |
否 |
String(1-32) |
被叫号码。 注：振铃事件的被叫号码为B号码。 |
subscriptionId |
否 |
String(1-64) |
绑定ID。 |
接口示例
POST /status HTTP/1.1
content-length:xx
{"eventType":"alerting","statusInfo":{"sessionId":"1200_1029_4294967295_20190123091514@callenabler246.huaweicaas.com","timestamp":"2019-01-23 09:15:16","caller":"+8613800000021","called":"+8613866887021","subscriptionId":"e97b2863-e7ad-4b4c-87c0-91b0171fe803"}}
参数名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
timestamp |
是 |
String(1-128) |
该呼叫事件发生时隐私保护通话平台的UNIX时间戳。 该参数取值为UTC时间（+8小时为北京时间）格式，即为“yyyy-MM-dd HH:mm:ss”。 |
sessionId |
是 |
String(1-256) |
唯一指定一条通话链路的标识ID。 |
caller |
否 |
String(1-32) |
主叫号码。 号码为全局号码格式（包含国家码），如+8613800000021。 注：应答事件的主叫号码为X号码。 |
called |
否 |
String(1-32) |
被叫号码。 注：应答事件的被叫号码为B号码。 |
subscriptionId |
否 |
String(1-64) |
绑定ID。 |
接口示例
POST /status HTTP/1.1
content-length:xx
{"eventType":"answer","statusInfo":{"sessionId":"1200_1029_4294967295_20190123091514@callenabler246.huaweicaas.com","timestamp":"2019-01-23 09:15:36","caller":"+8613800000021","called":"+8613866887021","subscriptionId":"e97b2863-e7ad-4b4c-87c0-91b0171fe803"}}
参数名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
timestamp |
是 |
String(1-128) |
该呼叫事件发生时隐私保护通话平台的UNIX时间戳。 该参数取值为UTC时间（+8小时为北京时间）格式，即为“yyyy-MM-dd HH:mm:ss”。 |
sessionId |
是 |
String(1-256) |
唯一指定一条通话链路的标识ID。 |
caller |
否 |
String(1-32) |
主叫号码。 号码为全局号码格式（包含国家码），如+8613800000021。 注：此处返回号码非真实主被叫号码，真实主被叫号码请以fee事件中的返回值为准。 |
called |
否 |
String(1-32) |
被叫号码。 注：此处返回号码非真实主被叫号码，真实主被叫号码请以fee事件中的返回值为准。 |
stateCode |
否 |
Integer |
通话挂机的原因值，仅当eventType为disconnect时携带。 取值范围及表示的含义请参考通话挂机原因值说明。 |
stateDesc |
否 |
String(1-128) |
通话挂机的原因值的描述，仅当eventType为disconnect时携带。 |
subscriptionId |
否 |
String(1-64) |
绑定ID。 |
接口示例
POST /status HTTP/1.1
content-length:xx
{"eventType":"disconnect","statusInfo":{"sessionId":"1200_1029_4294967295_20190123091514@callenabler246.huaweicaas.com","timestamp":"2019-01-23 09:16:41","caller":"+8613800000021","called":"+8613866887021","stateCode":0,"stateDesc":"The user releases the call.","subscriptionId":"e97b2863-e7ad-4b4c-87c0-91b0171fe803"}}
响应参数
客户服务器接收到隐私保护通话平台的呼叫事件通知后，返回的响应消息。
接口示例
HTTP/1.1 200 OK
