固话绑定AXB隐私号,是将拨打关系限定在一对一关系中,用户A可以通过固话中间号码X联系到用户B,用户B也可以通过中间号码X联系到用户A。固话隐私号目前为邀约制,请联系您的技术支持进行服务开通,并提供对接支持。
接口说明
在调用此接口前,请确保您已在控制台购买隐私号。您可以使用此接口给固话AXB中间号绑定号码,暂时不支持控制台号码管理页面给固话AXB中间号绑定A、B号码。
绑定号码前建议您先明确业务场景中的A角色和B角色。例如:在打车应用场景中,A是乘客角色,B是司机角色。
固话AXB中间号主要应用在1对1场景下的隐私保护,把A号码和B号码通过号码隐私服务实现绑定关系,A拨打X转接到B,B拨打X转接到A。一个固话X号码可以供N对绑定关系复用,如A1XB1、A2XB2、A3XB3......,只要A、B用户手机号码不重复,一个固话X号码可同时绑定N组手机号码,通话也可以同时进行。
号码复用次数根据您购买的号码有所不同,具体复用次数可以在号码购买时与您的技术支持确认。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
单击进入调试页面。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
AppId | String | 是 | 号池ID。 | FC10000016848**** |
Ts | String | 是 | 业务时间戳,格式:yyyyMMddHHmmssSSS,时间采用北京时间,24小时制,精确至毫秒。 | 20161114143116123 |
BindType | String | 是 | 绑定类型,取值:
| mode101 |
OrderId | String | 是 | 消息请求唯一标识。 | 123******* |
TelA | String | 是 | 固话AXB隐私号的A号码。 说明
|
|
TelX | String | 否 | 固话AXB隐私号的X号码。X号码是您在控制台已购买的隐私号。 说明 客户指定X号码模式下(即BindType参数为mode101),本参数必填。 | 0571******23 |
TelB | String | 是 | 固话AXB隐私号的B号码。 说明
|
|
Subts | String | 是 | 绑定时间,格式为yyyyMMddHHmmss。时间采用北京时间,24小时制。 | 20161114143116 |
Anucode | String | 是 | 主叫侧放音编码,固话AXB隐私号业务时必须设置。必须包含3个场景的编码。按照“B->X,A->X,其他号码->X”的顺序填写编码,编码之间以逗号分隔。 说明 “1,2,3”表示B->X放音编号为1,A->X放音编号为2,其他号码->X放音编号为3。 | 1,2,3 |
Anucodecalled | String | 否 | 接通后被叫侧放音编码,必须包含2个场景的编码。按照“A被叫,B被叫”的顺序填写编码,编码之间以逗号分隔。 说明 “1,2”表示A号码为被叫侧接听时的放音编号为1,B号码为被叫侧接听时的放音编号为2。 | 1,2 |
TAnucodeConnect | String | 否 | 接通后主叫侧的放音编码,必须包含2个场景的编码。按照“A被叫,B被叫”的顺序填写编码,编码之间以逗号分隔。 说明 “1,2”表示A号码为被叫时主叫侧的放音编号为1,B号码为被叫时主叫侧的放音编号为2。 | 1,2 |
Areacode | String | 否 | 区号。支持指定X号码归属地(指定城市->省会->全国路由)。不指定归属地,全国随机。 | 0571 |
Expiration | String | 是 | 过期时间,单位:秒,取值:
| 60 |
Remark | String | 否 | 外部业务扩展字段,通话记录回执消息中会回传此参数。不能超过100个字符长度。 | 19394 |
Extra | Object | 否 | 扩展参数。 | - |
Callrecording | String | 否 | 录音控制。取值:
说明 开启通话录音功能后,可在呼叫记录中播放和下载语音文件。录音文件按通话分钟计费0.010元/分钟。 | 0 |
返回参数
名称 | 类型 | 描述 | 示例值 |
AccessDeniedDetail | String | 权限校验失败详情。 | None |
Message | String | 响应消息。 | success |
RequestId | String | 请求ID,阿里云为该请求生成的唯一标识符。 | 649E9EB5-9436-53CF-B41A-C4F0433212E7 |
Data | Object | 响应内容。 | |
Subid | String | 绑定ID。 | GHX0************************* |
TelX | String | X号码。 | 0571******23 |
Code | String | 接口请求状态码。取值:
| 0 |
Success | Boolean | 接口调用是否成功。取值:
| true |
示例
正常返回示例:JSON格式。
{
"AccessDeniedDetail": "None",
"Message": "success",
"RequestId": "649E9EB5-9436-53CF-B41A-C4F0433212E7",
"Data": {
"Subid": "GHX0*************************",
"TelX": "0571******23"
},
"Code": "0",
"Success": true
}错误码
访问错误中心查看更多错误码。