跳转到主要内容

语音文件管理 - 编辑语音文件

一、接口异常错误说明

说明:ret为非200,msg为异常的错误信息。用来编辑语音文件,修改相关属性

{
    "ret":400, // 状态码
    "data":[],
    "msg":"非法

请求方式

POST,form-data格式

请求参数不合法" }

ret参数名 msg类型是否必须 说明
400service 非法请求string 一般为参数不合法App.Sip_Voice.EditAudio
500token string 服务器错误Token字符串
600id int token无效请重新登陆验证语音记录ID
601voicename appid未授权string 请检查appid或联系云呼科技是授权语音名称
602mark string appid授权已到期语音备注
603status int 模块未授权
604 IP未授权请联系厂商授权访问0:启用、1:禁用

二、接口请求正常,内部处理错误示例(PHP)

说明:ret为200。data结

<?php
    $apiUrl = 'http://127.0.0.1:8080';
    $postFields = [
        'service'   => 'App.Sip_Voice.EditAudio',
        'token'     => 'ABCDEFG',
        'id'     => '111',
        'voicename'     => '111',
    ];
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $apiUrl);
    curl_setopt($curl, CURLOPT_POST, 1);
    curl_setopt($curl, CURLOPT_POSTFIELDS, $postFields);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
    $response = curl_exec($curl);
    $curlError = curl_error($curl);
    curl_close($curl);
    var_dump($response);
?>

返回数据结体里status为1,desc为失败的中文描述,errors为详细错误信息,其中code码请参照对应说明。msg为空。

示例

{
    "ret": 200,
    "data": {
        "status": 1,0,
        "desc": "xxx失败获取成功",
        "errors": {
            "code": "1003",
            "codemsg": "授权失败"
        },
        "reqtime": 1507529858,1602655204,
        "rsptime": 15075298581602655204
    },
    "msg": ""
}
codecodemsg说明
1001服务器连接失败一般为网络原因
1002操作异常一般为校验异常等
1003操作失败一般是授权失败、注销失败、命令发送失败、服务器连接异常等
1010分机异常可能是新加的分机,需要重新登陆获取新token
1011非法分机非本公司所有
1012分机不存在分机号码状态
1013分机已停用分机号码状态
1014分机未注册分机号码状态
1015分机不在通话中分机号码状态
1016分机已启用分机号码状态
1017分机已注册分机号码状态
1018号码已启用主叫号码状态
1019号码已禁用主叫号码状态
1020号码不存在主叫号码状态
1021非法号码非本公司所有
1024任务不存在预测式任务接口返回状态
1025未开始预测式任务接口返回状态
1026进行中预测式任务接口返回状态
1027暂停预测式任务接口返回状态
1028已结束预测式任务接口返回状态
1201空闲分机合法、已启用并已注册
1202振铃分机号返回
1203摘机分机号返回
1204通话中分机号返回
1205用户拒接被叫方拒接
1210队列异常预测式外呼中返回
1211非法队列不存在或非本公司所有
1212未接听已分配未接听
1213等待中等待分配(示闲)
1214接收中队列中的分机状态
1215已接听队列里的分机状态
1216拒接队列里的分机状态
1217暂停示忙
1218已签入队列中已签入该分机
10001正常挂断挂机原因
10002呼叫取消挂机原因
10003拒绝接听挂机原因
10004外呼通道线路失败挂机原因
10005用户超时未接听挂机原因
10006用户忙挂机原因
10007服务器端挂断挂机原因
10008分机未注册挂机原因
10009目标不可达挂机原因
10011定时器超时挂机原因
10012呼入时回调接口错误挂机原因
10013分机不存在挂机原因
10014未发现挂机原因
10015请求超时挂机原因
10016无人接听挂机原因
10017呼叫失效挂机原因
10019归属地未知挂机原因
10020其它原因挂机原因
10024错误请求挂机原因
10025呼叫被禁止挂机原因
10027号码被改变挂机原因
10028呼叫拦截挂机原因
10031未知挂机原因
10040主叫挂机挂机方向
10041被叫挂机挂机方向