云服务器内容精选

  • 错误结果码 表4 错误原因码说明 序号 错误码 说明 1 0200001 参数异常,异常详情在resultDesc中描述。 2 0200006 数据库操作异常。 3 02000001 参数值为空 4 02000002 参数包含非法字符 5 02000003 参数长度不能大于规定长度 6 02000004 参数长度不能小于规定长度 7 02000005 参数长度需要介于规定长度之间 8 02000006 参数值类型不正确 9 02000007 参数值大小不正确 10 02000008 参数转换异常,请检查请求参数 11 02000009 参数组合不正确,请检查请求参数 12 02000010 hour和minute必须同时存在 13 02000011 参数个数不能大于规定个数
  • 接口URI https://ip:port/rest/isales/v1/openapi/campaigns/{vdnId}/blocklist 其中,ip为CC-iSales服务器地址,port为CC-iSales服务器的HTTPS端口号。 表1 URL中携带的参数说明 序号 参数名 参数类型 是否必选 说明 1 vdnId int True 虚拟呼叫中心ID。 取值的类型为整数,取值范围为1~9999。
  • 报文样例 该接口的请求消息体举例如下: { "limit":10, "offset":0, "importTaskIds":["164698362894300182038011895728"] } 该接口的响应消息体举例如下: { "result": [ { "succNum": 0, "failNum": 0, "errMsg": "", "id": "164698362894300182038011895728", "beginTime": "2022-03-11T07:27:09.000+00:00", "endTime": "2022-03-11T07:27:09.000+00:00", "repeatNum": 0, "status": "2" } ], "returnCode": "0200000", "resultCode": "0200000", "resultDesc": "success", "returnDesc": "success" }
  • 接口URI https://ip:port/rest/isales/v1/openapi/campaigns/{vdnId}/blackfile/queryDataImportTask 其中,ip为CC-iSales服务器地址,port为CC-iSales服务器的HTTPS端口号。 表1 URL中携带的参数说明 序号 参数名 参数类型 是否必选 说明 1 vdnId int True 虚拟呼叫中心ID。 取值的类型为整数,取值范围为1~9999。
  • 请求说明 表2 请求消息头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type String True 固定填 application/json; charset=UTF-8。 2 Authorization String True 生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 表3 请求消息体参数说明 序号 参数名 参数类型 是否必选 说明 1 offset int True offset用于确定查询的起始页。 offset取值为:offset=limit*(page-1) page为需要查询的起始页。 2 limit int True 表示每页的查询数量。 取值范围:1~100
  • 错误结果码 表6 错误原因码说明 序号 错误码 说明 1 0200001 参数异常,异常详情在resultDesc中描述。 2 0200006 参数包含非法字符 3 02000001 参数值为空 4 02000002 参数包含非法字符 5 02000003 参数长度不能大于规定长度 6 02000004 参数长度不能小于规定长度 7 02000005 参数长度需要介于规定长度之间 8 02000006 参数值类型不正确 9 02000007 参数值大小不正确 10 02000008 参数转换异常,请检查请求参数 11 02000009 参数组合不正确,请检查请求参数 12 02000010 hour和minute必须同时存在 13 02000011 参数个数不能大于规定个数
  • 响应说明 表6 消息体参数说明 序号 参数名 参数类型 说明 1 resultCode String 原因码。0200000表示成功,其他表示失败。 具体见表5。 2 resultDesc String 描述。 3 importTaskId String 文件导入任务ID 4 returnCode String 原因码。0200000表示成功,其他表示失败。 具体见表7 5 returnDesc String 描述。
  • 错误结果码 表7 错误原因码说明 序号 错误码 说明 1 0200001 参数异常,异常详情在resultDesc中描述。 2 02000001 参数值为空 3 02000002 参数包含非法字符 4 02000003 参数长度不能大于规定长度 5 02000004 参数长度不能小于规定长度 6 02000005 参数长度需要介于规定长度之间 7 02000006 参数值类型不正确 8 02000007 参数值大小不正确 9 02000008 参数转换异常,请检查请求参数 10 02000009 参数组合不正确,请检查请求参数 11 02000010 hour和minute必须同时存在 12 02000011 参数个数不能大于规定个数
  • 黑名单模板 请参考表1创建Excel模板文件。 表1 黑名单模板 黑名单号码(必填) 到期时间(非必填) 有效时长(非必填,单位:小时) 限制次数 限制周期 65676950 - - 1 1 88888888 2022-05-27 23:06:25 - - - 88888888 2022-06-24 10:06:25 - - - 12345678 2022-06-24 10:06:25 - - - 表2 黑名单模板参数说明 序号 参数名 参数类型 是否必选 说明 1 黑名单号码(必填) String True 号码最大长度为24个字符,有效字符为:0~9、*、# 2 到期时间(非必填) String False 到期时间,到期时间=新增时间点+有效时长。例:“2020-12-31 10:06:25”新增2条黑名单号码,有效时长120小时,则到期时间为“2021-01-05 10:06:25”。 3 有效时长(非必填,单位:小时) INT False 有效时长,单位小时,取值范围1~120。 4 限制次数 INT False 限制次数(与限制周期绑定,两者都填或都不填,范围:1-100) 5 限制周期 String False 限制周期(0:每小时;1:每天) 示例1:"restrictTimes":1,"restrictPeriod":"0" 表示2020-12-30 10:06:25 呼出一次,下次可呼出时间为2020-12-30 11:00:00 示例2:"restrictTimes":1,"restrictPeriod":"1" 表示2020-12-30 10:06:25 呼出一次,下次可呼出时间为2020-12-31 00:00:00
  • 接口URI https://ip:port/rest/isales/v1/openapi/campaigns/{vdnId}/blackfile/uploadFileServer 其中,ip为CC-iSales服务器地址,port为CC-iSales服务器的HTTPS端口号。 表3 URL中携带的参数说明 序号 参数名 参数类型 是否必选 说明 1 vdnId int True 虚拟呼叫中心ID。 取值的类型为整数,取值范围为1~9999。
  • 报文样例 该接口的请求消息体举例如下: { "serverId":"164690088271159234793429225848", "filePath":"/isales/upload", "fileName":"demoBlack.xlsx", "hour":"11", "minute":"00" } 该接口的响应消息体举例如下: { "returnCode": "0200000", "importTaskId": "164757251098048478018607266946", "resultCode": "0200000", "resultDesc": "数据导入中,请通过“导入结果”查看详细信息。", "returnDesc": "数据导入中,请通过“导入结果”查看详细信息。" }
  • 报文样例 该接口的请求消息体举例如下: { "blocklist": [ "13100000000", "13100000001", "13100000002", "13100000003" ], "validityExpirationTime":"2020-12-31 10:06:25", "restrictTimes":3, "restrictPeriod":"0" } 该接口的响应消息体举例如下: { "resultCode": "0200000", "resultDesc": "The blocklist is added successfully" }
  • 请求说明 表2 请求消息头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type String True 固定填 application/json; charset=UTF-8。 2 Authorization String True 生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 表3 请求消息体参数说明 序号 参数名 参数类型 是否必选 说明 1 blocklist List True 新增黑名单号码列表,最多20条。 号码最大长度为24个字符,有效字符为:0~9、*、# 2 validityExpirationTime String False 到期时间,到期时间=新增时间点+有效时长。例:“2020-12-31 10:06:25”新增2条黑名单号码,有效时长120小时,则到期时间为“2021-01-05 10:06:25”。 3 validityTime INT False 有效时长,单位小时,取值范围1~120。 4 restrictTimes INT False 限制次数(与限制周期绑定,两者都填或都不填,范围:1-100) 5 restrictPeriod String False 限制周期(0:每小时;1:每天) 示例1:"restrictTimes":1,"restrictPeriod":"0" 表示2020-12-30 10:06:25 呼出一次,下次可呼出时间为2020-12-30 11:00:00 示例2:"restrictTimes":1,"restrictPeriod":"1" 表示2020-12-30 10:06:25 呼出一次,下次可呼出时间为2020-12-31 00:00:00
  • 错误结果码 表5 错误原因码说明 序号 错误码 说明 1 0200001 参数异常,异常详情在resultDesc中描述。 2 0200006 数据库操作异常。 3 0200007 号码已存在黑名单中。 4 0200018 存在重复的号码。 5 0200029 超过了每次添加允许的最大值。 6 02000001 参数值为空 7 02000002 参数包含非法字符 8 02000003 参数长度不能大于规定长度 9 02000004 参数长度不能小于规定长度 10 02000005 参数长度需要介于规定长度之间 11 02000006 参数值类型不正确 12 02000007 参数值大小不正确 13 02000008 参数转换异常,请检查请求参数 14 02000009 参数组合不正确,请检查请求参数 15 02000010 hour和minute必须同时存在 16 02000011 参数个数不能大于规定个数
  • 使用说明 前提条件 已经申请了开发者账号。 使用限制 黑名单号码最大长度为24个字符。 黑名单号码有效字符为:0~9、*、#。 每次只能增加20条黑名单号码,否则提示“超过单次新增最大数量”,且不新增黑名单号码。 每次追加的黑名单号码不能有重复,否则提示“号码重复”,且不新增黑名单号码。 每次追加的黑名单号码中不能存在已有黑名单号码。 当同时传入有效时长和到期时间时,则以指定时间(validityexpirationtime)为准处理。 限制次数小于重试策略设置的试呼次数。