预约使用
即接即用，玖云平台为您提供稳定的通信能力
咨询热线：0755-33548988
开发者账户使用使用指南
开放接口使用指南
平台审核标准
平台服务标准
Rest API接口介绍
取消通话接口
通话记录查询接口
录音及下载接口
专线语音接口
专号通接口
专号通号码申请接口
专号通号码查询接口
专号通号码释放接口
应用映射号码查询接口
语音通知下发接口
取消预约语音通知接口
语音通知记录查询接口
语音验证码接口
智能语音验证接口
订单小号绑定接口
订单小号解绑接口
订单小号查询接口
订单小号话单查询接口
虚拟小号绑定接口
虚拟小号解绑接口
虚拟小号查询接口
虚拟小号在线呼叫接口
虚拟小号话单查询接口
工作号被叫绑定接口
云呼小号在线呼叫接口
批量上传号码接口
手机专号通绑定接口
手机专号通解绑接口
手机专号通更新接口
手机专号通查询接口
手机专号通双呼接口
云话机回拨接口
SDK产品简介
SDK集成指南
来电推送配置指南
Web
Android
Ios
更多
常见问题
专线语音回调通知接口
专号通回调通知接口
语音通知状态回调接口
语音验证码回调接口
智能语音验证回调接口
订单小号状态回调接口
虚拟小号状态回调接口
云呼小号状态回调
AI智能语音回调接口
语音回呼回调接口
手机专号通回调接口
云双呼回调接口
云呼AXB回调接口
云话机回调通知接口
全局错误码表
专线语音，也称点击呼叫、网页回拨（Click to
call），是通过传统电信专线外呼双方电话号码，双方接通后建立通话。基于玖云平台的专线语音接口，可用最少的代码，最快的时间让应用具有通信能力。
玖云平台专线语音REST接口通过HTTPS POST方式提交请求。
/{softVersion}/Accounts/{accountSid}/Calls/callBack
REST API是通过HTTPS POST方式请求。
| 属性 | 类型 | 约束 | 说明 |
| appId | String | 必选 | 应用ID |
| from | String | 必选 | 主叫电话号码。目前支持手机及固定电话 |
| to | String | 必选 | 被叫电话号码。目前支持手机及固定电话 |
| fromSerNum | List(String) | 可选 | 主叫侧显示号码列表。列表最多包含三个元素，第一个元素为优先显号号码，如无线路可以显该号，则显示备选号码中的一个。若为空则默认随机显号。所有显号号码必须通过平台审核后，才可使用，否则不显号 |
| toSerNum | List(String) | 可选 | 被叫侧显示号码列表。列表最多包含三个元素，第一个元素为优先显号号码，如无线路可以显该号，则显示备选号码中的一个。若为空则默认随机显号。若主叫侧为手机号码，被叫显示主叫真实手机号码时该号码无需审核，其余所有显号号码必须通过平台审核后，才可使用，否则不显号 |
| needRecord | int | 可选 | 是否录音：0表示不录音；1表示录音；默认值0 |
| userData | String | 可选 | 用户自定义数据，最长可支持128字节。如用户配置了回调接口，则在回调接口中将这一数据原样返回 |
| maxCallTime | int | 可选 | 通话的最大时长,单位为秒。当通话时长到达最大时长则挂断通话。默认值空。开发者设置的最大通话时长最长为8小时，超过8小时返回错误码。计时以主被叫建立通话为起始 |
参数说明：
(1).appId：应用ID
(2).from：主叫号码，需要进行号码检查，如号码不合法返回错误码
(3).to：被叫号码，需要进行号码检查，如号码不合法返回错误码
(4).fromSerNum：主叫侧显号，需要对用户传入显号号码进行权限检查（是否审核通过），如号码不合法则默认不显号；所有显号号码必须通过平台审核后，才可使用，否则不显号
(5).toSerNum：被叫侧显号，需要对用户传入显号号码进行权限检查（是否审核通过），如号码不合法则默认不显号；若主叫侧为手机号码，被叫显示主叫真实手机号码时该号码无需审核，其余所有显号号码必须通过平台审核后，才可使用，否则不显号
(6).needRecord：录音标志参数，录音文件下载地址在呼叫挂机计费通知回调(Hangup)中获取，非实时可以在官网通话记录界面进行下载。注：因录音文件需要时间同步到下载服务器，建议在获取到录音下载地址10分钟后再进行下载
(7).userData：用户自定义数据，最长可传入128字节，用户配置回调接口的情况下，将数据返回回调接口
(8).maxCallTime：最大通话时长，用于在请求通话时定义本次通话的最大通话时长
请求示例
JSON请求示例
POST
/2016-01-01/Accounts/798b9ec0eaa94142852aa2c402570146/Calls/callBack?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=
{
"callback": {
"appId": "feff3cbd52c041a1baab0492bee56423",
"from": "13912345678",
"to": "13812345678",
"fromSerNum": [
"13812345678"
],
"toSerNum": [
"13912345678"
],
"needRecord": "1",
"userData": "abcdef",
"maxCallTime": "120"
}
}
XML请求示例
POST
/2016-01-01/Accounts/798b9ec0eaa94142852aa2c402570146/Calls/callBack?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'?>
<callback>
<appId>feff3cbd52c041a1bd5aa492bee56423</appId>
<from>13912345678</from>
<to>13812345678</to>
<fromSerNum>[13812345678]</fromSerNum>
<toSerNum>[13912345678]</toSerNum>
<needRecord>1</needRecord>
<userData>abcdef</userData>
<maxCallTime>120</maxCallTime>
</callback>
| 属性 | 类型 | 约束 | 说明 |
| statusCode | String | 必选 | 请求状态码，取值000000（成功），参考Rest 错误代码 |
| subStatusCode | String | 可选 | 当请求状态码为000000（成功）时，该值可能不为空，用来描述不影响呼叫的错误，例如：显号参数错误等 |
| dateCreated | String | 必选 | 响应时间:格式"yyyy/MM/dd HH:mm:ss"；如：2016/01/01 12:00:00 |
| callId | String | 可选 | 一个由32个字符组成的电话唯一标识符，请求成功返回，请求失败不返回 |
| represent | String | 可选 | 错误描述，报错时返回，正常时不返回 |
响应示例
JSON响应示例
POST
HTTP/1.1 200 OK
Content-Length: 126
{
"resp": {
"statusCode": "000000",
"callId": "ca7b3057e11743afb43f8dd25ab60d30",
"dateCreated": "2016/03/24 15:36:52",
"subStatusCode": ""
}
}
XML响应示例
HTTP/1.1 200 OK
Content-Length: 197
<?xml version='1.0'?>
<resp>
<statusCode>000000</statusCode>
<callId>9d4c26f49d7f45b6917c105374bf4fc6</callId>
<dateCreated>2016/03/24 16:12:44</dateCreated>
<subStatusCode></subStatusCode>
</resp>
1 专线语音介绍
2 请求地址
3 请求包头
4 请求包体
5 响应包体
点击呼叫
