四川移动接口文档.doc

回拨电话业务 V 1.1 北京讯众通信技术股份有限公司 201-12-03 目 录 目录 1. 简介 2 2. 接口描述 2 2.1接口清单 2 2.2接口协议 2 2.3接口定义 3 2.3.1拨打电话 3 2.3.2取消拨打 5 2.3.3话单获取接口（增量方式） 7 2.3.4呼叫状态推送 8 简介 本文当旨在对讯众通信之间的接口规范进行说明。接口描述 2.1接口清单 接入服务器和通信能力服务器之间有以下接口： 拨打电话 通话账单 状态推送 接口协议 . 目前方案接口以Http+JSON接口定义 拨打电话业务体验描述： 用户A要用户B通话； 1、用户A向 平台发送点击拨号业务请求； 2、平台呼叫用户； 3、用户接听； 4、平台呼叫用户； 5、用户接听； 6、用户和用户通话； 拨打电话请求说明 通信协议 http 请求方法 Post Content-Type application/x-www-form-urlencoded; charset=UTF-8 访问URI 商用环境 call Request body请求参数 request url参数说明 默认都使用utf-8编码 参数名称 是否必选 参数类型 默认值 说明 loginid 是 String NA loginpwd 是 String NA src 是 String Null 01052084192|071352084192 dst 是 String Null 被叫号码，格式与主叫号码相同 credit 是 Int 0 单位为分钟。允许的最大通话分钟数这次通话最多能进行多长时间的通话。通话的计算是从被叫接通时刻计算。 statusNotifyUrl 否 String Null 状态推送 languageType 否 Int 0 播放TTS语音的语音。 请求示例 POST /callHTTP/1.1 Content-Type: application/x-www-form-urlencoded; charset=UTF-8 { ”loginid”:”4006056868”, ”loginpwd”:”d3c551ed984268fe7f5b4c0f720bca”, ”src”:”8618810207016”, ”dst”:”8618513728895”, ”credit”:”50”, ”statusNotifyUrl”:”34:8001/StatusNotify.aspx”, ”languageType”:”0” } 响应结果参数 响应消息参数说明 参数名称 是否必选 参数类型 默认值 说明 callId 是 NA 请求参数携带CallId errMsg 否 String NA 执行结果描述 errCode 否 Int NA 执行结果返回码 结果码 返回响应结果码说明 结果码 说明 0 成功 1010001 系统错误 1010002 主叫或被叫不能为空 1010003 剩余分钟不足 1010004 用户名密码错误 1010005 提交的电话号码格式错误 1010006 API达到调用上线 响应结果示例 HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 { errCode :0, callId :40d4711a801c7fb105ca06eb5f215e20, “errMsg”:” Success” } 2.3.2取消拨打 拨打电话业务体验描述： 用户A要用户B通话； 1、用户A向 平台发送点击拨号业务请求； 2、用户； 3、 平台；请求说明 通信协议 http 请求方法 Post Content-Type application/x-www-form-urlencoded; charset=UTF-8 访问URI 商用环境 cancel Request body请求参数 request url参数说明 默认都使用utf-8编码 参数名称 是否必选 参数类型 默认值 说明 是 String NA 本路通话的唯一标识id这个唯一的标识对应 caller 是 String Null callee 是 String Null 被叫号码 请求示例 POST /cancelHTTP/1.1 Content-Type: application/x-www-form-urlencoded; charset=UTF-8 { callId:867551091144411111111111111201, caller:8613866882006, callee:8613866882007, access_token:fabf92