双向回拨技术介绍

双向回拨是通过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"
        }
    }
}