检测给定文件中参数的相关性,并给出两两参数的相关系数。参数的相关系数为0-1之间的数值,数值越大相关性越高。在用户使用该API之前,需要登录数聚联网站,并申请成为开发者,创建新的应用,获得appid和appsecret.

1URL:
http://www.datamic.com/MIC/PreUpload
支持格式:
JSON
http请求方式:
POST
频次限制:
是(每秒最多请求一次)
请求参数
参数名参数描述
appidApp的DATAMIC APPKey
appsecretApp的DATAMIC APPSecret
filename要上传文件的文件名称
返回结果
正常情况下,返回JSON数据包:
{
	"retcode":"10000",
	"code":"ascdefghigklmn"
}
返回字段说明
字段类型说明
retcodeString返回结果码,用于表示成功或失败
codeString上传文件的临时凭证,code有效期为20分钟,如果获得code20分钟后,没有上传文件,视为code过期

错误时返回错误码等信息,JSON数据包示例如下(该示例为AppID无效错误):

{
	"errcode":"10002"
}
可能的错误码
100011000210005
注意事项
参数中的文件名称只包含文件名称,不包含路径信息,文件名称后缀必须是.csv;只接收form类型数据。
2URL:
http://www.datamic.com/MIC/Upload
支持格式:
JSON
http请求方式:
POST
频次限制:
是(每秒最多请求一次)
请求参数
参数名参数描述
code第一步中获取的临时凭证
file文件的全部或部分数据,当文件的数据量较大时,建议分段上传文件
返回结果
正常情况下,返回JSON数据包:
{
	"retcode":"10000"
}

错误时返回错误码等信息,JSON数据包示例如下(以code不正确为例说明)

{
	"retcode":"10003"
}
可能的错误码
100031000410005
注意事项
只接收form类型数据。
3URL:
http://www.datamic.com/MIC/Commit
支持格式:
JSON
http请求方式:
POST
频次限制:
是(每秒最多请求一次)
请求参数
参数名参数描述
code上传文件的临时凭证
filesize上传文件的大小
返回结果
正常情况下,返回JSON数据包:
{
	"retcode":"10000",
	"fileId":1208
}
返回字段说明
字段类型说明
retcodeString返回结果码,用于表示成功或失败
fileIdint获得的文件Id

错误时返回错误码等信息,JSON数据包示例如下(该示例为文件上传错误):

{
	"retcode":"10010"
}
可能的错误码
10003100041000510010
注意事项
参数中的文件大小单位是字节;只接收form类型数据。
4URL:
http://www.datamic.com/MIC/Progress
支持格式:
JSON
http请求方式:
POST
频次限制:
是(每秒最多请求一次)
请求参数
参数名参数描述
appidApp的DATAMIC APPKey
appsecretApp的DATAMIC APPSecret
fileId第三步中获取的fileId
返回结果

正常情况下,返回JSON数据包:

{
	"retcode":"10000",
	"filename":"test.csv",
	"progress":60,
	"remaintime",236
}
返回字段说明
字段类型说明
retcodeString返回结果码,用于表示成功或失败
filenameString上传文件的文件名称
progressint当前计算进度的百分百比。例如,progress值为60,那么当前计算进度为60%
remaintimeint到文件计算完成,还需要的秒数

错误时返回错误码等信息,JSON数据包示例如下(该示例为系统繁忙):

{
	"retcode":"10005"
}
可能的错误码
100021000510006
注意事项
循环获取文件计算进度时,相邻两次之间的时间间隔不能少于1秒,否则提示系统繁忙;只接收form类型数据。
5URL:
http://www.datamic.com/MIC/Result
支持格式:
JSON
http请求方式:
POST
频次限制:
是(每秒最多请求一次)
请求参数
参数名参数描述
appidApp的DATAMIC APPKey
appsecretApp的DATAMIC APPSecret
fileId第三步中获取的fileId
start从结果的第几条开始获取,start值从1开始
rows本次要获取结果的条数
返回结果

正常情况下,返回JSON数据包:

{
	"retcode":"10000",
	"result":[
       {
           "param1":"交通银行",
           "param2":"浦发银行",
           "ratio":"0.9378"
       },
       {
           "param1":"交通银行",
           "param2":"招商银行",
           "ratio":"0.9878"
       },
       {
          "param1":"浦发银行",
          "param2":"招商银行",
          "ratio":"0.9312"
       }
   ]
}
返回字段说明
字段类型说明
retcodeString返回结果码,用于表示成功或失败
result数组得到的结果数组
param1String参数1。例如用户上传的文件中有3个参数:交通银行、浦发银行、招商银行,返回结果是任意2个参数之间的相关性系数。共有3条结果记录,如上述JSON数据包中的result数组中有3条结果记录。每条结果记录中有3个键值:param1、param2、ratio。param1、param2分别代表相关的两个参数,ratio代表param1、param2的相关系数。
param2String参数2。描述见param1返回字段说明
ratioStringparam1和param2的相关性系数

错误时返回错误码等信息,JSON数据包示例如下(该示例为AppID无效错误):

{
	"retcode":"10007"
}
可能的错误码
100021000510006100071000810009
注意事项
返回的计算结果中result集合的长度,定义为结果的条数;只接收form类型数据。
错误列表
错误代码错误描述
10000操作成功
10001文件后缀不是.csv
10002您的appid和appsecret不合法
10003code不正确
10004code已过期
10005系统繁忙
10006fileId错误
10007文件还在运算过程中
10008文件运算过程中出现错误
10009start或rows参数错误
10010文件上传错误