# AXE模式接口使用说明
X表示隐私号码，E为分机号码，A为业务受益用户。
- A用户对外呈现的号码用X+E替代，A以外的用户呼叫X后根据语音提示输入E，呼叫转接至A，并产生一条回呼记录。
- A用户呼叫X，呼叫转接至最近一次通过X呼叫A的用户。若找不到对应回呼记录，则隐私保护通话平台根据绑定时的设置给A放指定音（callbackTone）后结束呼叫，或将呼叫转接至指定号码（callbackNum）。
一个X号码可以分配给多个A号码，但每个A号码对应的分机号E不同。每个X号码可分配的分机号E的最大数量可在添加应用时配置。如果您想要了解隐私保护通话AXE模式的功能，请参考[AXE模式功能详解](https://support.huaweicloud.com/productdesc-PrivateNumber/privatenumber_04_0006.html)。
AXE模式相关接口如下：
| 接口名称                                                                                            | 接口功能                                                | 请求发起方         | 请求接收方         | 备注                                                                                                                                                  |
|:---|:---|:---|:---|:---|
| [AXE模式绑定接口](https://support.huaweicloud.com/api-PrivateNumber/privatenumber_02_0022.html)       | 设置用户A和隐私号码X之间的绑定关系，并由隐私保护通话平台自动分配分机号E或由用户指定分机号E     | 客户应用（客户端）     | 隐私保护通话平台（服务端） | 设置了AXE的绑定关系后，其他用户才可通过X+E呼叫A。                                                                                                                        |
| [AXE模式绑定信息修改接口](https://support.huaweicloud.com/api-PrivateNumber/privatenumber_02_0023_1.html) | 修改已设置的AXE绑定关系的相关信息                                  | 客户应用（客户端）     | 隐私保护通话平台（服务端） | -                                                                                                                                                   |
| [AXE模式绑定信息查询接口](https://support.huaweicloud.com/api-PrivateNumber/privatenumber_02_0024.html)   | 查询已设置的AXE绑定关系信息                                     | 客户应用（客户端）     | 隐私保护通话平台（服务端） | -                                                                                                                                                   |
| [AXE模式呼叫事件通知接口](https://support.huaweicloud.com/api-PrivateNumber/privatenumber_02_0006_3.html) | 隐私保护通话平台向客户推送隐私保护通话用户呼叫时的状态信息，如呼入、呼出、振铃、应答、挂机等状态的信息 | 隐私保护通话平台（服务端） | 客户应用（客户端）     | 若要接收呼叫事件通知，客户[添加应用](https://support.huaweicloud.com/usermanual-PrivateNumber/pn_um_01.html)时需设置呼叫状态接收地址，并确保提供的地址能够正常处理隐私保护通话平台发送的通知消息。              |
| [AXE模式话单通知接口](https://support.huaweicloud.com/api-PrivateNumber/privatenumber_02_0006_3a.html)  | 隐私保护通话平台向客户推送通话的话单信息                                | 隐私保护通话平台（服务端） | 客户应用（客户端）     | 若要接收话单通知，客户[添加应用](https://support.huaweicloud.com/usermanual-PrivateNumber/pn_um_01.html)时需设置呼叫话单接收地址，并确保提供的地址能够正常处理隐私保护通话平台发送的通知消息。                |
| [X号码状态通知接口](https://support.huaweicloud.com/api-PrivateNumber/numstatus_notify_axe.html)        | X号码状态变化时，隐私保护通话平台会向客户推送X号码状态通知                      | 隐私保护通话平台（服务端） | 客户应用（客户端）     | 若要接收X号码状态通知，客户[添加应用](https://support.huaweicloud.com/usermanual-PrivateNumber/pn_um_01.html)时需设置呼叫状态接收地址并启用推送X号码状态功能，并确保提供的地址能够正常处理隐私保护通话平台发送的通知消息。 |
| [AXE模式解绑接口](https://support.huaweicloud.com/api-PrivateNumber/privatenumber_02_0023.html)       | 解除已设置的AXE绑定关系                                       | 客户应用（客户端）     | 隐私保护通话平台（服务端） | 绑定关系使用完毕后，客户可解除绑定关系，以达到重复使用隐私号码资源的目的。                                                                                                               |
| [获取录音文件下载地址接口](https://support.huaweicloud.com/api-PrivateNumber/privatenumber_02_0007_3.html)  | 获取录音文件的下载地址                                         | 客户应用（客户端）     | 隐私保护通话平台（服务端） | 客户从呼叫话单中获取到录音文件名后，可通过调用此接口获取录音文件下载地址。                                                                                                               |
   
#### API请求地址
API请求地址由"APP接入地址"和"访问URI"组成，数据来源如下：
| 参数      | 来源                                                                                          | 示例                                          |
|:---|:---|:---|
| APP接入地址 | 登录管理控制台，从隐私保护通话"[应用管理](https://console.huaweicloud.com/privatenumber/#/appManagement)"页面获取。 | https://rtcpns.cn-north-1.myhuaweicloud.com |
| 访问URI   | 从各API接口页面中的"接口类型说明"中获取。                                                                     | AXE模式绑定接口：/rest/caas/extendnumber/v1.0      |
   
综上，API请求地址示例如下：
设置AXE模式绑定关系
```
https://rtcpns.cn-north-1.myhuaweicloud.com/rest/caas/extendnumber/v1.0
```
#### API样例
下载Demo，快速开发应用：
- [Java](https://support.huaweicloud.com/devg-PrivateNumber/privatenumber_01_0001.html)
- [PHP](https://support.huaweicloud.com/devg-PrivateNumber/privatenumber_01_0016.html)
- [Python](https://support.huaweicloud.com/devg-PrivateNumber/privatenumber_01_0017.html)
- [C#](https://support.huaweicloud.com/devg-PrivateNumber/privatenumber_01_0018.html)
- [Node.js](https://support.huaweicloud.com/devg-PrivateNumber/privatenumber_01_0019.html)
 
#### 注意事项
因运营商管控，固话号码只能接收来自X号码的呼叫，不能作为主叫呼叫X号码。即AXE模式中，当A用户的号码为固话号码时，其他用户（手机号码）可以拨打X号码后输入分机号联系A用户，但A用户无法通过拨打X号码回呼之前通话用户或企业指定号码。