开发文档-星沃云

接口文档

更新时间：2021-01-01 15:33

签名算法

以POST方式访问平台接口，所有POST参数merge形成一个Key-Value形式的待签名数组，数组中不包含sign参数。将参数数组根据key做正向排序，然后用key1=value1&key2=value......的形式拼接起来，形成待签名的字符串(值为空字符串或null不参与签名参数和key需要小写)。并计算所得到的字符串的MD5值,即为sign的值。 sign=MD5(a=1&b=2&c=3&d=5)注意，所有通过POST传递的参数，都应该参与

拨打电话

请求URL

https://api.cicti.cn/call/companyCall

请求方式

POST

参数

参数名	必选	类型	说明
appld	是	String	公司账号的 appld
appSecret	是	String	公司账号的 appSecret
telA	是	String	主叫号码
telB	是	String	被叫
timestamp	是	String	时间戳
sign	是	String	签名

响应值

参数名	类型	说明
code	Integer	响应状态码
msg	String	相应的状态信息
time	String	时间戳
data	String	响应数据
subid	String	本次调用返回唯一Id

返回示例


				
					{
				
				
					
						"code"：200,
					
					
						"msg"："请求成功"
					
					
						"time"： "2021-07-25 18:31:29",
					
					
						"data"： {
					
					
						"subid"："04202107251831296890045359"
					
					
						}
					
				
				
					}

200 => '请求成功',

//1001 - 1999 客户端引起的错误

1002 => '非法请求',//（post & get 请求不正确）

1003 => '参数错误',//具体是什么参数错误，可以在返回的时候输入 msg 参数

1004 => '签名无效',//--基类

1005 => '认证错误',//token 无效--基类

1006 => '请求无效',//（时间校验失败）--基类

//2000 - 2999 服务器的业务交互的错误提示

2000 => '服务器繁忙', //服务器返回友好提示

2001 => '未知错误',

2002 => '没有更多数据了',//（针对列表式加载更多）

2003 => '暂无数据',//数据不存在

//3001 - 4000 服务器错误（用户自定义的错误，都应该在这个段）

3001 => '服务器处理异常',

//7001 - 8001 线路拨打失败

7001 => '正在呼叫中', //线路拨打失败

7002 => '绑定关系已存在', //线路拨打失败

9001 => '费用不足，请联系平台充值！' //费用不足，请联系平台充值！

获取通话记录

说明

待查询通话记录最多保存 30 天，超过 30 天的，登录平台查询。通话记录查询过一次以后不再返回。单次调用最多返回 50 条记录。

请求URL

https://api.cicti.cn/call/companyCall

请求方式

POST

参数

参数名	必选	类型	说明
appld	是	String	公司账号的 appld
appSecret	是	String	公司账号的 appSecret
timestamp	是	String	时间戳
sign	是	String	签名

响应值

参数名	类型	说明
code	Integer	响应状态码
msg	String	相应的状态信息
time	String	时间戳
data	String	响应数据
subid	String	本次调用返回唯一Id

返回示例


				
					{
				
				
					
						"code"：200,
					
					
						"msg"："请求成功"
					
					
						"time"： "2021-07-25 18:31:29",
					
					
						"data"： {
					
					
						
							
								"total": 50,
							
							
								 "rows":[
							
							
								
									
										{
									
									
										
											"subid": 
											"04202107251831296890045359", //发起通话请求时响应的唯一id
										
										
											"telA":
											"18888888888",//主叫号码
										
										
											"telX": 
											"16666666666",//中间号
										
										
											"telB": 
											"19999999999",//被叫号码
										
										
											"startTime": 
											"2021-07-25 18:31:29",//通话开始时间
										
										
											"endTime": 
											"2021-07-25 18:33:29", //通话截止时间
										
										
											 "duration": 
											 120,//通话时长，单位秒
										
										
											"status": 
											1, //通话状态拨打状态 1 已拨打（未接通）2 呼叫受限 5 已接通
										
										
											"unaswRsn": 
											"客户忙",
										
										
											"downloadUrl":
										
										
											"https://api.cicti.cn/call/companyRecordDownlaod/04202107251831296890045359"
										
									
									
										},
									
									
										...
									
								
							
							
								]
							
						
					
					
						}
					
				
				
					}

获取录音文件

请求URL

https://api.cicti.cn/call/companyRecordDownlaod/${subid}

请求方式

GET

参数

参数名	必选	类型	说明
appld	是	String	公司账号的 appld
appSecret	是	String	公司账号的 appSecret
timestamp	是	String	时间戳
sign	是	String	签名

响应值

文件流

地址

昆山新南中路567号双星叠座

热线

400-996-7299

微信&手机

155-9909-2111

防封电销系统服务地区：北京 | 上海 | 广州 | 深圳 | 杭州 | 成都 | 郑州 | 武汉 | 沈阳 | 西安 | 南京 | 苏州 |

星沃云智慧平台产品禁止用于含有木马、病毒、色情、赌博、电信诈骗等违法违规业务。一经发现，星沃云有权立即停止服务，并协助公安执法机关进行清查。

中华人民共和国增值电信业务经营许可证：B1.B2-20233040 备案号：苏ICP备2023010229号 sitemap 苏公网安备32058302003764