预约使用
即接即用，玖云平台为您提供稳定的通信能力
咨询热线：0755-33548988
开发者账户使用使用指南
开放接口使用指南
平台审核标准
平台服务标准
Rest API接口介绍
取消通话接口
通话记录查询接口
录音及下载接口
专线语音接口
专号通接口
专号通号码申请接口
专号通号码查询接口
专号通号码释放接口
应用映射号码查询接口
语音通知下发接口
取消预约语音通知接口
语音通知记录查询接口
语音验证码接口
智能语音验证接口
订单小号绑定接口
订单小号解绑接口
订单小号查询接口
订单小号话单查询接口
虚拟小号绑定接口
虚拟小号解绑接口
虚拟小号查询接口
虚拟小号在线呼叫接口
虚拟小号话单查询接口
工作号被叫绑定接口
云呼小号在线呼叫接口
批量上传号码接口
手机专号通绑定接口
手机专号通解绑接口
手机专号通更新接口
手机专号通查询接口
手机专号通双呼接口
云话机回拨接口
SDK产品简介
SDK集成指南
来电推送配置指南
Web
Android
Ios
更多
常见问题
专线语音回调通知接口
专号通回调通知接口
语音通知状态回调接口
语音验证码回调接口
智能语音验证回调接口
订单小号状态回调接口
虚拟小号状态回调接口
云呼小号状态回调
AI智能语音回调接口
语音回呼回调接口
手机专号通回调接口
云双呼回调接口
云呼AXB回调接口
云话机回调通知接口
全局错误码表
接入流程
(1).创建应用并配置用户的AS服务器地址即回调地址
(2).用户AS服务器端开发相应接口
(3).开始使用
请求地址配置
请求地址为开发者服务器地址，具体配置方式如下：
此接口用于呼叫断开的时候，平台通知第三方应用服务器。包括正常断开以及异常断开情况。
回调请求地址
用户自行配置URL地址。通过POST方式请求通知用户，提供XML和JSON格式。
回调请求包头
| 属性 | 类型 | 约束 | 说明 |
| Content-Type | String | 必选 | 类型application/xml |
| Content-Length | String | 必选 | 消息体的长度 |
回调请求包体
| 属性 | 类型 | 约束 | 描述 | 取值 |
| action | String | 必选 | 请求类型 | Hangup |
| type | int | 必选 | 呼叫类型 | 22:直拨 |
| appId | String | 必选 | 应用ID | |
| callId | String | 必选 | 呼叫的唯一标示 | 32位字符串 |
| telX | String | 必选 | 主被叫绑定的小号 | |
| caller | String | 可选 | 主叫号码 | |
| called | String | 可选 | 被叫号码 | |
| startTime | String | 可选 | 通话开始时间 | YYYYMMDDHH24MISS 20130212000256 |
| endTime | String | 必选 | 通话结束时间 | YYYYMMDDHH24MISS |
| duration | String | 必选 | 通话时长。如被叫未接听，则为0 | 单位：秒 |
| byeType | String | 必选 | 通话挂机类型 | 0:正常挂断 1:A无法接通 2:B无法接通 3:A目标忙 4:B目标忙 5:通话达到最大时长 6:服务器错误 7:网络错误 255:其他错误 |
| dateCreated | String | 必选 | 请求时间 | 回调用户的时间 |
| recordUrl | String | 必选 | 录音回调地址 | URL格式，未开启录音，则为空，录音下载有延时 |
参数说明：
1)action：请求类型
2)type：呼叫类型
3)appId：应用ID
4)callId：呼叫的唯一标示
5)telX：业务员发起呼叫时绑定的小号X
6)caller：主叫号码
7)called：被叫号码
8)startTime：通话开始时间
9)endTime：通话结束时间
10)duration：通话时长。如被叫未接听，则为0
11)byeType：通话挂机类型
12)dateCreated：请求时间
13)recordUrl：录音回调地址
回调请求示例
XML请求示例
POST
<?xml version='1.0'?>
<req>
<action>Hangup</action>
<type>22</type>
<appId>7290fa01293c483fb2709c690f213272</appId>
<callId>9f1ffdf1273511e7a80d000c29779dd9</callId>
<telX>18643210001</telX>
<startTime>20170911145109</startTime>
<endTime>20170422163810</endTime>
<duration>0</duration>
<byeType>0</byeType>
<dateCreated>20161106190844</dateCreated>
<recordUrl>http://xxx.xx/download/record1</recordUrl>
</req>
用户AS响应包头
| 属性 | 类型 | 约束 | 说明 | 举例 |
| Status-Code | String | 必选 | 应答状态码，全部为200 | HTTP/1.1 200 OK |
| Date | String | 可选 | 服务器时间 | Wed Nov 9 16:08:57 2011 |
| Content-Length | String | 必选 | 消息体的长度 | 140 |
用户AS响应包体
| 属性 | 类型 | 约束 | 描述 | 取值 |
| statusCode | String | 必选 | 响应结果 | 用户返回错误码 0000表示成功，目前平台不对此字段进行解析 |
| statusMsg | String | 可选 | 响应结果描述 | 用户自定义描述，目前平台不对此字段进行解析 |
用户AS响应示例
XML响应示例
POST
<?xml version='1.0' encoding='utf-8'?>
<Response>
<statusCode>0000</statusCode>
<statusMsg>Success</statusMsg>
</Response>
1
2
3
点击呼叫
