1.语音双向回拨
请通过HTTPS POST方式提交请求,有联云融合通讯开放平台收到请求后,将向两个电话终端发起呼叫,双方接通电话后进行通话。
请求
请求地址
/Accounts/{AccountSid}/Calls/callBack
请求包头
详情请查阅统一请求包头,并使用开发者账号进行验证。
请求包体
属性 | 类型 | 约束 | 说明 |
---|---|---|---|
appId | String | 必选 | 应用Id |
clientId | String | 必选 | 主叫clientNumber号码,clientNumber必须是绑定了主叫正常的电话号码。申请Client |
callee | String | 必选 | 被叫正常电话号码。 |
caller | String | 必选 | 主叫正常电话号码。 |
callerDisplay | String | 可选 | 主叫侧显示的号码,只能显示400号码或固话。查阅显号规则。 |
calleeDisplay | String | 可选 | 被叫侧显示的号码。可显示手机号码、400号码或固话。查阅显号规则。 |
XML请求示例
/Accounts/1784fd62ae354a1eca54f8b34e5a9baf/Calls/callBack.xml?sig=C80B3CA83E40F3947C41B15BE0523FB2 Host:app.youlianyun.com Accept:application/xml Content-Type:application/xml;charset=utf-8 Authorization:MTc4NGZkNjJhZTM1NGExZWNhNTRmOGIzNGU1YTliYWY6MjAxNTEwMTMxNjA3NTY= <?xml version="1.0" encoding="UTF-8"?> <appId>950a97bce77b885b747536a1e3887465</appId> <clientId>61207000000015</clientId> <callee>15012345678</callee> <caller>13823501990</caller> <callerDisplay>4001234567</callerDisplay> <calleeDisplay>4000004567</callerDisplay>
JSON请求示例
/Accounts/1784fd62ae354a1eca54f8b34e5a9baf/Calls/callBack?sig=C80B3CA83E40F3947C41B15BE0523FB2 Host:app.youlianyun.com Accept:application/json Content-Type:application/xml;charset=utf-8 Authorization:MTc4NGZkNjJhZTM1NGExZWNhNTRmOGIzNGU1YTliYWY6MjAxNTEwMTMxNjA3NTY= { "appId" : "950a97bce77b885b747536a1e3887465", "clientId" : "61207000000015", "callee" : "15012345678", "caller" : "13823501990", "callerDisplay" : "4001234567", "calleeDisplay" : "4000004567" }
响应
响应包体
属性 | 类型 | 约束 | 说明 |
---|---|---|---|
respCode | String | 必选 | 请求状态码,取值200(success) |
reason | String | 必选 | 回调结果 |
callId | String | 必选 | 呼叫的唯一标识 |
XML响应示例
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <respCode>200</respCode> <reason>success</reason> <callId>60000000000008mRrDm254582</callId>
JSON响应示例
{ "respCode" : "200", "reason" : "success", "callId" : "60000000000008mRrDm254582" }
2.取消回拨
取消回拨是支持客户用于任意时间段结束双向回拨呼叫的能力接口。通过此REST API可以实现对误操作外呼的取消功能。 通过HTTPS GET方式提交请求,平台收到请求后,取消双向回拨通话。
请求
• 请求地址
/Accounts/{AccountSid}/Calls/callCancel
• 请求包头
请参阅统一请求包头,使用子账户进行验证
• 请求包体
属性 | 类型 | 约束 | 说明 |
---|---|---|---|
appId | String | 必选 | 应用Id |
callId | String | 必选 | 一个由32个字符组成的电话唯一标识符 |
• XML请求示例
https://app.youlianyun.com/Accounts/1784fd62ae354a1eca54f8b34e5a9baf/Calls/callCancel.xml?sig=C80B3CA83E40F3947C41B15BE0523FB2&appId=950a97bce77b885b747536a1e3887465&callId=ce199b9f4264684379311d9c87ffe7c4 Authorization:MTc4NGZkNjJhZTM1NGExZWNhNTRmOGIzNGU1YTliYWY6MjAxNTEwMTMxNjA3NTY=
• JSON请求示例
https://app.youlianyun.com/Accounts/1784fd62ae354a1eca54f8b34e5a9baf/Calls/callCancel?sig=C80B3CA83E40F3947C41B15BE0523FB2&appId=950a97bce77b885b747536a1e3887465&callId=5ac53758dbb79e0ec19e179756c84e25 Authorization:MTc4NGZkNjJhZTM1NGExZWNhNTRmOGIzNGU1YTliYWY6MjAxNTEwMTMxNjA3NTY=
响应
• 响应包体
属性 | 类型 | 约束 | 说明 |
---|---|---|---|
respCode | String | 必选 | 请求状态码,取值200(success) |
reason | String | 必选 | 回调结果 |
• XML响应示例
<?xml version="1.0" encoding="UTF-8"?> <respCode>200</respCode> <reason>success</reason>
• JSON响应示例
{ "respCode" : "200" "reason" : "success" }