双向回拨技术介绍
目录
双向回拨技术介绍
双向回拨是通过PC、WEB或移动客户端经IP网络发起通话请求，由云平台分别向双方拨打落地电话，并由云平台桥接实现通话的方式。在国内或国际漫游的情况下，可以通过双向回拨的通话方式，变拨打电话为接听电话，节省漫游费用。并且通话不受网速影响，通话效果和传统电话一样，不耗费流量。
请通过HTTPS POST方式提交请求，云之讯融合通讯开放平台收到请求后，将向两个电话终端发起呼叫，双方接通电话后进行通话。
1.1 请求
• 请求地址
/{SoftVersion}/Accounts/{AccountSid}/Calls/callBack
• 请求包头
详情请查阅统一请求包头，并使用开发者账号进行验证。
• 请求包体
| 属性 | 类型 | 约束 | 说明 |
|---|---|---|---|
| appId | String | 必选 | 应用Id |
| fromClient | String | 必选 | 主叫ClientNumber号码，ClientNumber必须是绑定了主叫正常的电话号码。 |
| to | String | 必选 | 被叫正常电话号码。 |
| fromSerNum | String | 可选 | 主叫侧显示的号码，只能显示400号码或固话。查阅 |
| toSerNum | String | 可选 | 被叫侧显示的号码。可显示手机号码、400号码或固话。查阅 |
| maxallowtime | String | 可选 | 允许通话时长单位为秒（值必须为60的倍数，如60s、120s、180s） |
• XML请求示例
POST /2014-06-30/Accounts/e03bc9106c6ed0eaebfce8c362edcd32/Calls/callBack.xml?sig=45E5592AB04D18B5B008E5C8D4C4137C
Host:api.ucpaas.com
Accept:application/xml
Content-Type:application/xml;charset=utf-8
Authorization:ZTAzYmM5MTA2YzZlZDBlYWViZmNlOGMzNjhmZGNkNDg6MjAxNDA5MTgxNjUxNDk=
<?xml version="1.0" encoding="UTF-8"?>
<callback>
<appId>b23abb6d451346efa13370172d1921ef</appId>
<fromClient>61207000000015</fromClient>
<to>15012345678</to>
<fromSerNum>4001234567</fromSerNum>
<toSerNum>075512345678</toSerNum>
<maxallowtime>910</maxallowtime>
</callback>
• JSON请求示例
POST /2014-06-30/Accounts/e03bc9106c6ed0eaebfce8c362edcd32/Calls/callBack?sig=6ED038FAFE6DEC41E20C3D17167CA256
Host:api.ucpaas.com
Accept:application/xml
Content-Type:application/xml;charset=utf-8
Authorization:ZTAzYmM5MTA2YzZlZDBlYWViZmNlOGMzNjhmZGNkNDg6MjAxNDA5MTgxNjQ4MTg=
{
"callback" : {
"appId" : "b23abb6d451346efa13370172d1921ef",
"fromClient" : "61207000000015",
"fromSerNum" : "4001234567",
"to" : "15012345678",
"toSerNum" : "075512345678",
"maxallowtime" : "910"
}
}
1.2 响应
• 响应包体
| 属性 | 类型 | 约束 | 说明 |
|---|---|---|---|
| respCode | String | 必选 | 请求状态码，取值000000（成功） |
| createDate | String | 必选 | 电话的创建时间 |
| callId | String | 必选 | 呼叫的唯一标识 |
• XML响应示例
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<resp>
<respCode>000000</respCode>
<callback>
<createDate>20140623184315</createDate>
<callId>60000000000008mRrDm254582</callId>
</callback>
</resp>
• JSON响应示例
{
"resp" : {
"respCode" : "000000",
"callback" : {
"createDate" : "20140918164816",
" callId " : "60000000000008mRrDm254582"
}
}
}