隐私小号绑定接口AXB

注:接口调用需要用到统一鉴权、用于确认账户信息和请求的合理性。

1、创建关联关系接口

接口地址:openapi/call/api/axb/create 请求方式:POST
字段说明
字段名称类型约束说明
requestIdstring(36)必须每次请求的唯一标识
telAstring(20)必须一般放主叫号码
telXstring(20)必须小号
telBstring(20)必须一般放被叫号码
expirationint可选有效时间,单位:秒,缺省有效时间为 3600(即 1 小时)有效值范围为 1 至 604800(即 7 天) 创建关联完成后计为起始时间, 同时系 统也会将“起始时间+有效时间”计算并 保存一个结束
请求示例
{ "requestId": "1234333", "telA": "137782207", "telX": "173075722", "telB": "183029784" }
请求响应
字段名称类型约束说明
codeint必须状态码,200 表示成功 其他表示失败
msgstring条件失败时,错误原因描述必填
dataDataInfo条件200 时,数据必填
DataInfo
seqIdstring(32)必须绑定关系的序列号

2、删除关联关系接口

该接口用于在生效时间到期自动删除前,提前删除号码的绑定关系
接口地址:call/api/axb/delete
请求方式:POST
字段说明:
字段名称类型约束说明
requestIdstring(36)非必须每次请求的唯一标识
seqIdstring(32)必须绑定关系的序列号
telXstring(20)必须必填
请求响应
字段名称类型约束说明
codeint必须状态码,200 表示成功 其他表示失败
msgstring条件失败时,错误原因描述必填

3、CDR 推送接口

接口提供方:客户
字段名称类型约束说明
idstring (32)必须语音为 call-id
serviceTypestring (8)必须业务类型:voice
inboundCallerstring (20)必须呼入主叫
inboundCalleestring (20)必须呼入被叫
outboundCallerstring (20)必须呼出主叫
outboundCalleestring (20)必须呼出被叫
connectTimestring (20)可选接通时间
endTimestring (20)可选呼叫结束时间
talkTimeint(8)可选通话时长,单位:秒
recordUrlstring (256)条件录音文件提取方式向企业客户推送录音时
注:录音保存时间为 3 个月

4、绑定接口

POST /call/util/BX/bind请求体
参数名类型是否必填说明
telBStringY主叫号码-座席自己手机号
telXStringY工作号码-小号
示例
{ "telB": "13856789123", "telX": "15923456789" }
返回结果
参数名类型是否必填说明
successbooleanY是否成功
messageStringY提示消息
dataStringYXB绑定的关系id
codeStringY成功:200
traceIdStringY请求唯一标识
示例
{ "success": true, "message": "200 ok!", "code": "200", "data":"xxxxx1112", "traceId": "76e0770ec0f14d3fb5a8f1cde9bf89f0" }

5、解绑接口

POST /call/util/BX/unbind请求体
参数名类型是否必填说明
telBStringY主叫号码
telXStringY工作号码
示例
{ "telB": "13856789123", "telX": "15923456789" }
返回结果
参数名类型是否必填说明
successbooleanY是否成功
messageStringY提示消息
dataStringYXB绑定的关系id
codeStringY成功:200
traceIdStringY请求唯一标识
示例
{ "success": true, "message": "200 ok!", "code": "200", "data":"xxxxx1112", "traceId": "76e0770ec0f14d3fb5a8f1cde9bf89f0" }

6、绑定回调接口

POST 客户方提供请求体
参数名类型是否必填说明
statusYString工作号当前状态:6:实名失败 7:实名过期 8:待实名 9:实名成功
telBYString主叫号码
telXYString工作号码
authIdYString工作号关系绑定的唯一标识
descNString实名绑定失败原因描述
示例
{ "telB": "13856789123", "telX": "15923456789" "status": "6", "authId": "1233", "desc": "实名失败" }
说明:返回code为200表示接收成功

7、解绑回调接口

POST 客户方提供请求体
参数名类型是否必填说明
statusYString工作号当前状态:5:待使用 11:解绑失败
telBYString主叫号码
telXYString工作号码
authIdYString工作号关系绑定的唯一标识
descNString号码解绑失败原因描述
示例
{ "telB": "13856789123", "telX": "15923456789" "status": "11", "authId": "1233", "desc": "解绑失败" }
说明:返回code为200表示接收成功
2025-08-05