API标准及多语言预置SDK
本产品（号码隐私保护服务/2017-05-25）的 OpenAPI 采用 RPC 签名机制，具体签名方式请参见签名机制说明。我们已为开发者封装了主流编程语言的 SDK，您可通过 下载 SDK 快速调用 API，无需关注签名等底层实现细节，显著降低开发门槛与集成复杂度。自定义签名场景
若您的业务场景有特殊需求，需通过自签名方式对接 API，建议优先咨询我们的技术支持团队（服务钉钉群：147535001692），获取专业指导以确保高效接入。
账号与安全准备
阿里云账号具备对所有资源的完全管理权限。一旦 AccessKey 泄露，所有相关资源都将面临未经授权访问的风险。为确保安全，建议创建一个仅具备 API 访问权限的 RAM 用户并配置其 AccessKey，同时基于最小权限原则 (PoLP) 配置 RAM 策略。仅在明确需要阿里云账号权限的特定场景下，才使用阿里云账号。
实际使用人报备A号码报备
| API | 标题 | API概述 |
|---|---|---|
| DeleteSecretAPhoneNoToCust | 删除A号码报备记录 | A号码报备数据删除。 |
| QuerySecretAPhoneNoToCust | 查询A号码报备状态 | A号码报备状态查询。 |
| CreateFixedNoAReport | 提交A号码固话个人实名信息 | 通过API提交A号码固话个人信息报备。 |
| GetDyplsOSSInfoForUploadFile | 获取A号码报备OSS配置信息 | 获取OSS资源配置信息，此配置信息将用于后续OSS图片上传操作。 |
| CreatePhoneNoAReport | 提交A号码手机号个人实名信息 | 通过API提交A号码手机号个人信息报备。 |
添加号码绑定
| API | 标题 | API概述 |
|---|---|---|
| BindAxb | AXB中间号-号码绑定 | AXB中间号，是将拨打关系限定在一对一关系中，用户A可以通过中间号码X联系到用户B，用户B也可以通过中间号码X联系到用户A。 |
| BindAxn | AXN隐私号-号码绑定 | 添加AXN隐私号的绑定关系。AXN隐私号是为A用户分配一个专属的隐私号，任何号码N通过拨打X号码都可以转接到A。 |
| BindAxnExtension | AXN分机号-号码绑定 | 添加AXN分机号的绑定关系。AXN分机号与AXN隐私号功能类似，AXN分机号在AXN基础上引入了分机号，从而降低X号码的使用量，在呼叫时候首先拨打X号码，听到提示音后输入对应分机号转接到A。 |
| BindAxg | AXG隐私号-号码绑定 | 添加AXG号码的绑定关系。AXG产品是针对有用户分级需求、限制呼叫范围、限制抢单等场景的客户需求提供的号码隐私保护解决方案，其中G代表一个号码组，可以根据需要添加号码。 |
| BindBatchAxg | 批量添加AXG号码的绑定关系 | 批量添加AXG号码的绑定关系。AXG产品是针对有用户分级需求、限制呼叫范围、限制抢单等场景的客户需求提供的号码隐私保护解决方案，其中G代表一个号码组，可以根据需要添加号码。 |
| UpdateSubscription | 修改已绑定的号码 | 修改号码的绑定关系。 |
| UnbindSubscription | 解除已绑定的号码 | 解除号码的绑定关系。 |
查询号码绑定
| API | 标题 | API概述 |
|---|---|---|
| QuerySubscriptionDetail | 查询号码绑定详情 | 查询号码的绑定详情。获取号码绑定关系状态、分机号码、是否录音、ASR状态等信息。 |
| QuerySubsId | 查询号码绑定ID | 查询绑定关系的唯一标识SubsId。 |
| QuerySecretNoDetail | 查询隐私号码属性 | 查询隐私号码的属性信息。 |
G号码组
| API | 标题 | API概述 |
|---|---|---|
| CreateAxgGroup | 创建G号码组 | 创建G号码组。仅AXG隐私号类型的号码池支持设置G号码组。 |
| OperateAxgGroup | 修改G号码组 | 修改G号码组中的号码，可以对号码进行添加、删除、全量替换操作。 |
| DeleteAxgGroup | 删除G号码组 | 删除G号码组。仅AXG隐私号类型的号码池支持设置G号码组。 |
录音及ASR获取
| API | 标题 | API概述 |
|---|---|---|
| QueryRecordFileDownloadUrl | 获取录音文件的下载链接 | 根据号码池Key、呼叫记录ID、呼叫发起时间等获取录音文件的下载链接。 |
| GetTotalPublicUrl | 获取响铃放音的录音下载链接 | 获取响铃放音的录音下载链接。 |
| GetSecretAsrDetail | 获取ASR识别结果详情 | 获取ASR识别结果详情。 |
号码资源管理
| API | 标题 | API概述 |
|---|---|---|
| AddSecretBlacklist | 添加黑名单 | 向号码池添加黑名单。仅AXN隐私号、AXN分机号、95AXN隐私号类型的号码池支持设置黑名单。 |
| DeleteSecretBlacklist | 删除黑名单 | 删除号码池的黑名单。仅AXN隐私号、AXN分机号、95AXN隐私号类型的号码池支持设置黑名单。 |
| OperateBlackNo | 新增或删除黑名单 | 新增或删除号池黑名单。仅AXN隐私号、AXN分机号、95AXN隐私号类型的号码池支持设置黑名单。 |
| ReleaseSecretNo | 释放号码 | 释放号码。释放后所选号码将不可继续使用。 |
| LockSecretNo | 锁定号码 | 锁定号码。适用于需要临时屏蔽异常号码的场景。 |
| UnlockSecretNo | 解锁号码 | 解锁号码。解除号码的临时屏蔽。 |
电商物流行业接口
| API | 标题 | API概述 |
|---|---|---|
| AddAxnTrackNo | 为AXN隐私号添加运单号 | 为AXN隐私号添加运单号。 |
| QueryPhoneNoAByTrackNo | 进行运单号广播推送 | 广播推送运单号。 |
其他
| API | 标题 | API概述 |
|---|---|---|
| BindAxnExtensionFixedLine | AXN分机号绑定 | 固话AXN分机号在固话AXN隐私号基础上引入了分机号，从而降低X号码的使用量，在呼叫时候首先拨打X号码，听到提示音后输入对应分机号转接到A。固话AXN分机号目前为邀约制，请联系您的技术支持进行服务开通，并提供对接支持。 |