检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
业务平台推送呼叫状态给开发者应用，仅支持POST方式。 接口类型 表1 接口类型说明 请求方法 POST 访问URI 客户添加应用时填写的呼叫状态接收地址 通信协议 HTTPS/HTTP 请求参数 AXB模式中，A和B通过X号码形成绑定关系，使用隐私号码X互相通讯。 以下流程和接口示例以A拨打X，呼叫转接至B
AXB模式相关接口如下： 接口名称 接口功能 请求发起方 请求接收方 备注 AXB模式绑定接口 设置用户A、隐私号码X和用户B之间的绑定关系 客户应用（客户端） 隐私保护通话平台（服务端） 设置了AXB的绑定关系后，A和B才可通过X号码进行联系。 AXB模式绑定信息修改接口 修改已设置的AXB绑定关系的相关信息
详解。 AXYB模式相关接口如下： 接口名称 接口功能 请求发起方 请求接收方 备注 AXYB模式绑定接口 设置以下绑定关系： 用户A和隐私号码X的绑定关系 AX、用户B和隐私号码Y的绑定关系 客户应用（客户端） 隐私保护通话平台（服务端） 客户调用此接口分别设置了A和X、B和Y
AXYB模式呼叫事件通知接口 接口功能 隐私保护通话平台通过此接口向客户推送隐私保护通话用户呼叫时的状态信息，如呼入、呼出、振铃、应答、挂机等状态的信息。 请求方向 隐私保护通话平台（服务端） → 客户服务器（客户端） 使用说明 前提条件 客户添加应用时需设置呼叫状态接收地址，并
AXE模式呼叫事件通知接口 接口功能 隐私保护通话平台通过此接口向客户推送隐私保护通话用户呼叫时的状态信息，如呼入、呼出、振铃、应答、挂机等状态的信息。 请求方向 隐私保护通话平台（服务端） → 客户服务器（客户端） 使用说明 前提条件 客户添加应用时需设置呼叫状态接收地址，并确
myhuaweicloud.com 访问URI 从各API接口页面中的“接口类型说明”中获取。 获取录音文件下载地址接口 ：/rest/provision/voice/record/v1.0 综上，API请求地址示例如下： 获取录音文件下载地址接口 https://rtcpns.cn-north-1
userData 否 String(1-256) 用户附属信息。 当客户在AX模式绑定接口、AX模式绑定信息修改接口或AX模式设置临时被叫接口中携带了“userData”时，对应此呼叫事件的通知消息中都会携带此参数。 接口示例 POST /status HTTP/1.1 content-type:
信息单元不存在 100 无效的信息单元 101 呼叫状态不一致 102 定时器超时 103 参数不存在 110 消息中带有未识别的参数 111 协议错误 127 未指定的交互 父主题： 附录
附录 通话挂机原因值说明 Q850原因值说明 呼叫拆线点说明 其他附加性说明
调用接口时遇到“1010040：The app_key is not allowed to invoke the API.”如何处理？ 出现该错误码表示调用的接口和app_key所属的应用模式不一致。如添加应用时选择的AXB模式的应用，调用接口时只能调用AXB模式的接口，不能调用其他模式的接口。
AX模式 AX模式接口使用说明 AX模式绑定接口 AX模式解绑接口 AX模式绑定信息修改接口 AX模式绑定信息查询接口 AX模式设置临时被叫接口 AX模式呼叫事件通知接口 AX模式话单通知接口 X号码状态通知接口 获取录音文件下载地址接口 短信通知接口
AXB模式 AXB模式接口使用说明 AXB模式绑定接口 AXB模式解绑接口 AXB模式绑定信息修改接口 AXB模式绑定信息查询接口 AXB模式呼叫事件通知接口 AXB模式话单通知接口 X号码状态通知接口 获取录音文件下载地址接口 短信通知接口
X模式 X模式接口使用说明 X模式呼叫事件通知接口 X模式话单通知接口 X号码状态通知接口 获取录音文件下载地址接口 短信通知接口
AXYB模式 AXYB模式接口使用说明 AXYB模式绑定接口 AXYB模式解绑接口 AXYB模式绑定信息查询接口 AXYB模式呼叫事件通知接口 AXYB模式话单通知接口 X号码状态通知接口 获取录音文件下载地址接口 终止呼叫接口
AXE模式 AXE模式接口使用说明 AXE模式绑定接口 AXE模式解绑接口 AXE模式绑定信息修改接口 AXE模式绑定信息查询接口 AXE模式呼叫事件通知接口 AXE模式话单通知接口 X号码状态通知接口 获取录音文件下载地址接口
新增AXYB模式相关接口 2019/3/4 “短信通知接口”支持失败重传机制、支持获取短信发送结果 “AX/AXB/AXE模式绑定接口”支持X号码对应城市严格匹配模式 2019/2/1 新增“X号码状态通知接口” “短信通知接口”支持获取用户发送的短信内容 “获取录音文件下载地址接口”录音下载地址有效期变更为3天
呼叫拆线点说明 拆线点 拆线点描述 0 接通后主动挂机 522 语音端口不足 7001 开发者呼叫频次管控 7002 应用呼叫频次管控 7003 主显号码呼叫频次管控 7004 被叫黑名单呼叫管控 7005 主叫黑名单管控 7100 应用信息不存在 7101 应用未申请隐私号码资源
其他附加性说明 本文档中提供的API接口均采用短连接，OMP作为服务端时会主动拆链，建议客户端不要主动拆链，等接收到服务端的FIN, ACK后按照正常四次挥手拆链。 若客户端主动拆链，可能造成该链路对应的端口短时间不可用，影响客户发送请求。 父主题： 附录
通话挂机原因值说明 分类 错误码 描述 - 0 接通后主动挂机 绑定关系 8013 无效AX模式呼叫（存在AX绑定，但无临时被叫） 8014 无效AXB/X模式呼叫（绑定关系不存在，号码格式错误等） 8016 AX/AXB模式呼叫方向不允许 8019 回呼记录不存在 AXE模式，A呼叫X场景
调用AXB模式接口时遇到“1012007：The record does not exist”如何处理？ 调用“AXB模式绑定/解绑接口”时出现该错误码，请按以下步骤排查问题： 调用接口时参数格式填写错误。请对照接口文档查看参数格式填写是否正确：例如参数取值中是否携带了多余的空格、填写的号码格式是否正确。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
