呼叫前鉴权请求接口
呼叫前鉴权请求接口通常纯网络语音、直拨、回拨，通过鉴权可以查询该用户在您服务器的余额、或者其他状态。默认情况下您的应用服务器需要存储您的用户相关信息，并且这类信息由您的应用服务器进行控制。
当您要针对语音通话进行录音的同时，当前情况下必须启用鉴权服务，并且在鉴权内由您的应用服务器进行返回相关是否启用录音的通知。
1.1 呼叫前鉴权请求接口
• 请求地址
需要第三方自行配置URL地址。
• 请求包体
| 属性 | 类型 | 约束 | 说明 |
|---|---|---|---|
| accountid | String | 必选 | 开发者账号id |
| appid | String | 必选 | 应用id |
| clientId | String | 必选 | 主叫clientId。申请Client |
| clientNumber | String | 必选 | 被叫号码。 |
• POST参数示例，请获取请使用标准的POST参数读取
| 参数 | 值 |
|---|---|
| accountid | aae25ec101fc12087516bc6564d0aa73 |
| appid | 950a97bce77b885b747536a1e3887465 |
| clientId | 61207000000015 |
| clientNumber | 1380013800 |
1.2 第三方AS响应
响应包体
| 属性 | 类型 | 约束 | 说明 |
|---|---|---|---|
| retcode | int | 必选 | 返回错误码，0：成功，非0：失败; 注：该错误码支持开发者自定义错误码，并且透传至应用层，方便AS与客户端之间的通讯。 开发者自定义错误码的规则是：int类型：10000~20000范围之间。 |
| reason | string | 可选 | 原因描述，可以支持中文描述 |
| displaynumber | string | 可选 | 被叫显号号码 |
| allowedcalltime | string | 可选 | 允许通话时长单位为分钟（值必须为正整数），若需控制当前通话时长，allowedcalltime传入的值必须大于或等于0，平台将按此值控制当前通话时长；当allowedcalltime传入的值小于0时，平台默认不限制当前通话时长。 |
• POST参数示例，请获取请使用标准的POST参数读取
| 参数 | 值 |
|---|---|
| retcode | 0 |
| reason | 1003 |
| displaynumber | 18612345678 |
| allowedcalltime | 910 |