预约使用
即接即用,玖云平台为您提供稳定的通信能力
开发者账户使用使用指南
开放接口使用指南
平台审核标准
平台服务标准
Rest API接口介绍
取消通话接口
通话记录查询接口
录音及下载接口
专线语音接口
专号通接口
专号通号码申请接口
专号通号码查询接口
专号通号码释放接口
应用映射号码查询接口
语音通知下发接口
取消预约语音通知接口
语音通知记录查询接口
语音验证码接口
智能语音验证接口
订单小号绑定接口
订单小号解绑接口
订单小号查询接口
订单小号话单查询接口
虚拟小号绑定接口
虚拟小号解绑接口
虚拟小号查询接口
虚拟小号在线呼叫接口
虚拟小号话单查询接口
工作号被叫绑定接口
云呼小号在线呼叫接口
批量上传号码接口
手机专号通绑定接口
手机专号通解绑接口
手机专号通更新接口
手机专号通查询接口
手机专号通双呼接口
云话机回拨接口
SDK产品简介
SDK集成指南
来电推送配置指南
Web
Android
Ios
更多
常见问题
专线语音回调通知接口
专号通回调通知接口
语音通知状态回调接口
语音验证码回调接口
智能语音验证回调接口
订单小号状态回调接口
虚拟小号状态回调接口
云呼小号状态回调
AI智能语音回调接口
语音回呼回调接口
手机专号通回调接口
云双呼回调接口
云呼AXB回调接口
云话机回调通知接口
全局错误码表
开发者调用订单小号绑定接口前,需要先建立号码池(具体方法可联系工作人员)。号码池建立后,通过本接口动态申请一个可用X号码(可指定),该号码可用于映射真实号码A,B之间的通话。
/{softVersion}/Accounts/{accountSid}/AxbNumber/bind
REST API是通过HTTPS POST方式请求。
参数名称 | 类型 | 约束 | 说明 |
appId | String | 必选 | 应用ID |
telA | String | 必选 | 通话A号码,支持手机和固话 |
telX | String | 可选 | 通话双方显示的X号码,可指定 |
telB | String | 必选 | 通话B号码,支持手机、固话和95号码 |
areacode | String | 可选 | 申请小号的区号,根据这一参数在号码池中选择对应的号码,如不传此参数在号码池所有号码中选择 |
otherArea | String | 可选 | 只能输入true或false,默认为false。当输入true时,输入的areacode区的X号码池无资源时,允许从其他区号资源池随机选取X号码 |
callDisplay | String | 可选 | 显号控制,0:显示真实号码,1:显示X 号码;默认值0。并不是所有的X号码资源都支持显示真实号码,关于这点请咨询客服 |
expiration | int | 可选 | 绑定关系有效时长,秒为单位。必须大于0,若为空则默认24小时 |
userData | String | 可选 | 用户自定义数据,最长可支持128字节。如用户配置了回调接口,则在回调接口中将这一数据原样返回 |
参数说明:
(1).appId:应用ID
(2).telA:通话A号码,支持手机和固话
(3).telX:通话双方显示的X号码,不传入时会在X号码池随机选取
(4).telB:通话B号码,支持手机、固话和95号码
(5).areacode:申请小号的区号,根据这一参数在号码池中选择对应的号码,如不传此参数在号码池所有号码中选择
(6).otherArea:只能输入true或false,默认为false。当输入true时,输入的areacode区的X号码池无资源时,允许从其他区号资源池随机选取X号码
(7).callDisplay:显号控制,0:显示真实号码,1:显示X 号码;默认值0。并不是所有的X号码资源都支持显示真实号码,关于这点请咨询客服
(8).expiration:绑定关系有效时长,秒为单位。必须大于0,默认24小时
(9).userData:用户自定义数据,最长可传入128字节,用户配置回调接口的情况下,将数据返回回调接口
请求示例
JSON请求示例POST /2016-01-01/Accounts/798b9ec0eaa94142852aa2c402570146/AxbNumber/bind?sig= 6949C5F977B304EC5BB969FD8838D345HTTP/1.1 Host:127.0.0.1:9080 content-length: 272 Accept: application/json; Content-Type: application/json;charset=utf-8; Authorization: Nzk4YjllYzBlYWE5NDE0Mjg1MjYwMmM0AAI1NzAxNDY6MjAxNjAzMjQxNTE3MDE= { "req": { "appId":"7290fa01293c483fb2709c690f213272", "telA":"18617068888", "telX":"13036894925", "telB":"13410247777", "areacode":"0779", "otherArea":"true", "expiration":"60", "userData":"AA,BB,CC" } }XML请求示例
POST /2016-01-01/Accounts/798b9ec0eaa94142852aa2c402570146/AxbNumber/bind?sig= 230AB7B77C951C9DB5FECD55B3AFB3CFHTTP/1.1 Host:127.0.0.1:9080 content-length: 357 Accept: application/xml; Content-Type: application/xml;charset=utf-8; Authorization: Nzk4YjllYzBlYWE5NDE0Mjg1MjYwMmMAADI1NzAxNDY6MjAxNjAzMjQxNjA2MjI= <?xml version='1.0' encoding='utf-8'?> <req> <appId>7290fa01293c483fb2709c690f213272</appId> <telA>18617068888</telA> <telX>13036894925</telX> <telB>13410247777</telB> <areacode>0779</areacode> <otherArea>true</otherArea> <expiration>60</expiration> <userData>AA,BB,CC</userData> </req>
属性 | 类型 | 约束 | 说明 |
statusCode | String | 必选 | 请求状态码,取值000000(成功),可参考 Rest 错误代码 |
dateCreated | String | 必选 | 响应时间:格式"yyyy/MM/dd HH:mm:ss"。如:2016/01/01 12:00:00 |
represent | String | 可选 | 错误描述,报错时返回,请求正常不返回 |
subid | String | 可选 | 系统分配,唯一标示本次绑定关系的ID,解绑时使用 |
telX | String | 可选 | 系统分配的小号X |
info | String | 可选 | 非本区X号码,本区X号码资源池用完后,返回本参数 |
响应示例
JSON响应示例HTTP/1.1 200 OK Content-Length: 126 { "resp": { "statusCode": "000000", "dateCreated": "2016/03/24 15:36:52", "subid": "A2102X779X0008005970", "telX": "13036894925", "info": "非本区X号码" } }XML响应示例
HTTP/1.1 200 OK Content-Length: 197 <?xml version='1.0'?> <resp> <statusCode>000000</statusCode> <dateCreated>2016/03/24 16:12:44</dateCreated> <subid>A2102X779X0008005970</subid> <telX>13036894925</telX> <info>非本区X号码</info> </resp>
2 请求地址
3 请求包头
4 请求包体
5 响应包体