这里会显示出您选择的修订版和当前版本之间的差别。
| 两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
|
呼叫鉴权请求接口 [2015/05/28 10:19] duanyonghong |
呼叫鉴权请求接口 [2017/08/23 08:44] (当前版本) |
||
|---|---|---|---|
| 行 1: | 行 1: | ||
| + | ======呼叫鉴权请求接口====== | ||
| + | |||
| + | 呼叫鉴权请求接口通常纯网络语音、语音验证码、在线会议，通过鉴权可以查询该用户在您服务器的余额、或者其他状态。默认情况下您的应用服务器需要存储您的用户相关信息，并且这类信息由您的应用服务器进行控制。 | ||
| + | |||
| + | * 如不启用鉴权，默认针对您应用下的开发者计费，将只检测开发者主账户的余额。 | ||
| + | * 如不启用鉴权，默认通过SDK直拨的服务将只能显示您在平台预先绑定的号码。 | ||
| + | |||
| + | 当您要针对语音通话进行录音的同时，当前情况下必须启用鉴权服务，并且在鉴权内由您的应用服务器进行返回相关是否启用录音的通知。 | ||
| + | |||
| ==== 1.1 呼叫鉴权请求接口 ==== | ==== 1.1 呼叫鉴权请求接口 ==== | ||
| 行 8: | 行 17: | ||
| |event |String |必选 |值为：callreq | | |event |String |必选 |值为：callreq | | ||
| |callid |String |必选 |呼叫的唯一标识（sdk组件生成） | | |callid |String |必选 |呼叫的唯一标识（sdk组件生成） | | ||
| - | |accountid |String |必选 |开发者账号id | | + | |accountid |String |必选 |开发者账号id| |
| |appid |String |必选 |应用id | | |appid |String |必选 |应用id | | ||
| - | |calltype |int |必选 |0：直拨，1：免费，2：回拨 | | + | |calltype |int |必选 |1：免费 | |
| - | |callertype |int |必选 |主叫号码类型，0：Client账号，1：普通电话| | + | |subcalltype |int |可选 |1:音频、2:视频（此字段当calltype=1时生效 ）| |
| - | |callerchargetype |int |必选 |主叫计费类型，0：开发者计费1：PAAS平台计费，默认为0 | | + | |callertype |int |必选 |主叫号码类型，0：Client账号，1：普通电话，2：userid | |
| + | |callernum|String|必选 |用户绑定的号码| | ||
| + | |callerchargetype |int |必选 |主叫计费类型，0：开发者计费，1：PAAS平台计费，默认为0 | | ||
| |callerbalance |float |必选 |在PAAS平台主叫帐户钱包余额(单位:元) | | |callerbalance |float |必选 |在PAAS平台主叫帐户钱包余额(单位:元) | | ||
| |caller |String |必选 |主叫号码 \\ 普通电话：18612345678 \\ Client号码：60000000000017 | | |caller |String |必选 |主叫号码 \\ 普通电话：18612345678 \\ Client号码：60000000000017 | | ||
| - | |calledtype |int |必选 |被叫号码类型，0：Client账号，1：普通电话 | | + | |calledtype |int |必选 |被叫号码类型，0：Client账号，1：普通电话，2：userid | |
| |called |string |必选 |被叫号码 \\ 普通电话：18612345678 \\ Client号码：60000000000017 | | |called |string |必选 |被叫号码 \\ 普通电话：18612345678 \\ Client号码：60000000000017 | | ||
| |userData|string |可选 |用户自定义数据字符串，最大长度128字节 | | |userData|string |可选 |用户自定义数据字符串，最大长度128字节 | | ||
| 行 51: | 行 62: | ||
| |reason |string |可选 |原因描述，可以支持中文描述 | | |reason |string |可选 |原因描述，可以支持中文描述 | | ||
| |record |String |可选 |是否录音；0：不录音；1：录音；默认为0。 | | |record |String |可选 |是否录音；0：不录音；1：录音；默认为0。 | | ||
| - | |displaynumber |string |可选 |被叫显号号码，具体显号规则请查看《显号规则说明》 | | + | |displaynumber |string |可选 |白名单号码 | |
| |allowedcalltime |string |可选 |允许通话时长单位为秒（值必须为60的倍数，如60s、120s、180s），若需控制当前通话时长，allowedcalltime传入的值必须大于或等于0，平台将按此值控制当前通话时长；当allowedcalltime传入的值小于0时，平台默认不限制当前通话时长。 | | |allowedcalltime |string |可选 |允许通话时长单位为秒（值必须为60的倍数，如60s、120s、180s），若需控制当前通话时长，allowedcalltime传入的值必须大于或等于0，平台将按此值控制当前通话时长；当allowedcalltime传入的值小于0时，平台默认不限制当前通话时长。 | | ||
| - | |userData|string |可选 |用户自定义数据字符串，最大长度128字节 | | + | |userData |String|可选 |用户自定义数据字符串，最大长度128字节| |
| **• XML响应示例 ** | **• XML响应示例 ** | ||
