中易开发平台Web服务器端API接口描述
1、新增辅助资料数据
http请求方式：POST
url：服务器地址/AssAdd.ashx? AppKey=appkey&UserID=操作用户ID&TypeID=辅助资料类别号&Code=数据代码&Name=数据名称
返回说明
正确的Json返回结果:
{“err”:0, “ID”:分配的数据内码}
错误的Json返回结果：
{“err”:1,”msg”:”错误信息”}
2、更新辅助资料数据
http请求方式：POST
url：服务器地址/AssUpdate.ashx? AppKey=appkey&UserID=操作用户ID&ID=数据内码&Code=数据代码&Name=数据名称
返回说明
正确的Json返回结果:
{“err”:0, “msg”:””}
错误的Json返回结果：
{“err”:1, “msg”:”错误信息”}
1、新增基础资料数据
http请求方式：POST
url：服务器地址/BasicAdd.ashx?AppKey=appkey&UserID=操作用户ID
数据：
{
“ItemClassID”:"基础资料类别号",
“BaseField”:[
{
“Name”:"字段名称",
“Value”:"值"
},
{
“Name”:"字段名称",
“Value”:值
}
],
“Detail”:[
{
“Name”:"子表表名",
“Rows”:[
{
“Field”:[
{
“Name”:"字段名称",
“Value”:值
}
]
},
{
“Field”:[
{
“Name”:"字段名称",
“Value”:值
}
]
}
]
}
]
}
参数说明
参数 | 说明 |
ItemClassID | 基础资料类别号 |
BaseField | 主表字段集合，字段为Name和Value的键值对数组 |
Detail | 子表集合，基础资料在启用自定义模板时，可以支持子表数据。子表数据包含Rows集合，每个Rows又包含相同的Field字段集合。 |
|
|
返回说明
正确的Json返回结果:
{“err”:0, “ID”:分配的数据内码}
错误的Json返回结果：
{“err”:1, “msg”:”错误信息”}
2、新增基础资料数据2
http请求方式：POST
url：服务器地址/BasicAdd2.ashx?AppKey=appkey&UserID=操作用户ID
数据：
{
“ItemClassID”:"基础资料类别号",
“BaseField”:{
“FieldName”:Value,
“FieldName”:Value,
…
}
“Detail”:{
“DetailTableName”:[{
“FieldName”:Value,
“FieldName”:Value,
…}]
}
}
参数说明
参数说明 |
|
ItemClassID | 基础资料类别号 |
BaseField | 主表字段列表，字段为FieldName和Value的键值对列表 |
Detail | 子表对象，基础资料在启用自定义模板时，可以支持子表数据。子表数据包子表列表，每个子表又包含相同的Field字段列表。 |
|
|
返回说明
正确的Json返回结果:
{“err”:0, “ID”:分配的数据内码}
错误的Json返回结果：
{“err”:1, “msg”:”错误信息”}
3、新增基础资料数据（钉钉连接器专用）
http请求方式：POST
url：服务器地址/BasicAdd_DD.ashx?AppKey=appkey&DDUserID=钉钉UserID
数据：
{
“ItemClassID”:"基础资料类别号",
“BaseField”:{
“FieldName”:Value,
“FieldName”:Value,
…
}
“Detail”:{
“DetailTableName”:[{
“FieldName”:Value,
“FieldName”:Value,
…}]
}
}
4、更新基础资料数据
http请求方式：POST
url：服务器地址/BasicUpdate.ashx? AppKey=appkey&UserID=操作用户ID
数据：同新增，BaseField集合中必须包含“FID”键值列，FID是基础资料数据的内码。
错误的Json返回结果：
{“err”:1, “msg”:”错误信息”}
5、更新基础资料数据2
http请求方式：POST
url：服务器地址/BasicUpdate2.ashx? AppKey=appkey&UserID=操作用户ID
数据：同新增2。
错误的Json返回结果：
{“err”:1, “msg”:”错误信息”}
6、更新基础资料数据（钉钉连接器专用）
http请求方式：POST
url：服务器地址/BasicUpdate2.ashx? AppKey=appkey&UserID=操作用户ID
数据：同新增（钉钉连接器专用）。
错误的Json返回结果：
{“err”:1, “msg”:”错误信息”}
1、新增单据数据
http请求方式：POST
url：服务器地址/BillAdd.ashx? AppKey=appkey&UserID=操作用户ID
数据：
{
“TemplateID”:"单据模板号",
“BaseField”:[
{
“Name”:"字段名称",
“Value”:"值"
},
{
“Name”:"字段名称",
”Value“:值
}
],
”Detail“:[
{
”Name“:"子表表名l",
”Rows“:[
{
”Field“:[
{
”Name“:"字段名称",
”Value“:值
}
]
},
{
”Field“:[
{
”Name“:"字段名称",
”Value“:值
}
]
}
]
}
]
}
参数说明
参数说明 |
|
TemplateID | 单据模板号 |
BaseField | 主表字段集合，字段为Name和Value的键值对数组 |
Detail | 子表集合，子表数据包含Rows集合，每个Rows又包含相同的Field字段集合。 |
|
|
返回说明
正确的Json返回结果:
{“err”:0, “BillID”:分配的数据内码}
错误的Json返回结果：
{“err”:1, “msg”:”错误信息”}
2、新增单据数据2
http请求方式：POST
url：服务器地址/BillAdd2.ashx? AppKey=appkey&UserID=操作用户ID
数据：
{
“TemplateID”:"单据模板代码",
“BaseField”:{
“FieldName”:Value,
“FieldName”:Value,
…
}
“Detail”:{
“DetailTableName”:[{
“FieldName”:Value,
“FieldName”:Value,
…}]
}
}
3、新增单据数据（钉钉连接器专用）
http请求方式：POST
url：服务器地址/BillAdd_DD.ashx?AppKey=appkey&DDUserID=钉钉UserID
数据：
{
“TemplateID”:"单据模板代码",
“BaseField”:{
“FieldName”:Value,
“FieldName”:Value,
…
}
“Detail”:{
“DetailTableName”:[{
“FieldName”:Value,
“FieldName”:Value,
…}]
}
}
4、修改单据数据
http请求方式：POST
url：服务器地址/BillUpdate.ashx? AppKey=appkey&UserID=操作用户ID&BillID=单据内码
数据：同新增时提交的数据，必须包含FBillID字段
返回说明
正确的Json返回结果:
{“err”:0, “msg”:””}
错误的Json返回结果：
{“err”:1, “msg”:”错误信息”}
5、修改单据数据
http请求方式：POST
url：服务器地址/BillUpdate2.ashx? AppKey=appkey&UserID=操作用户ID&BillID=单据内码
数据：同新增时提交的数据，必须包含FBillID字段
返回说明
正确的Json返回结果:
{“err”:0, “msg”:””}
错误的Json返回结果：
{“err”:1, “msg”:”错误信息”}
6、修改单据数据（钉钉连接器专用）
http请求方式：POST
url：服务器地址/BillUpdate_DD.ashx?AppKey=appkey&DDUserID=DD用户ID&BillID=单据内码
数据：同新增时提交的数据，必须包含FBillID字段
返回说明
正确的Json返回结果:
{“err”:0, “msg”:””}
错误的Json返回结果：
{“err”:1, “msg”:”错误信息”}
7、审核单据数据
http请求方式：POST
url：服务器地址/BillCheck.ashx? AppKey=appkey&UserID=操作用户ID&TemplateID=单据模板号&BillID=单据内码&Level=审核级别
返回说明
正确的Json返回结果:
{“err”:0, “msg”:””}
错误的Json返回结果：
{“err”:1, “msg”:”错误信息”}
8、弃审单据数据
http请求方式：POST
url：服务器地址/BillUnCheck.ashx? AppKey=appkey&UserID=操作用户ID&TemplateID=单据模板号&BillID=单据内码&Level=审核级别
返回说明
正确的Json返回结果:
{“err”:0, “msg”:””}
错误的Json返回结果：
{“err”:1, “msg”:”错误信息”}
四、数据库访问
1、SQL 查询
http请求方式：GET
url：服务器地址/ GetDataTable.ashx? AppKey=appkey&SQL=Select语句
返回说明
正确的Json返回结果:
{“err”:0, “Count”:数据行数,”Data”:[{“Name”,””字段名,”Value”:”值”},{}]}
错误的Json返回结果：
{“err”:1, “msg”:”错误信息”}
2、获取值
http请求方式：GET
url：服务器地址/ GetSingleValue.ashx? AppKey=appkey&SQL=Select语句
返回说明
正确的返回结果:
{“err”:0,”value”:值}
错误的Json返回结果：
{“err”:1, “msg”:”错误信息”}
访问签名方式：
没一个API访问地址栏必须加上AppKey参数，AppKey为开发平台中Web接入管理中设置的接口AppKey
如果对应的接口AppKey设置了
APISecret鉴权方式，则调用者必须在Headers中加入时间戳（x-zypaas-signature-timestamp）和签名（x-zypaas-signature）两个参数，具体签名算法
Basic Auth方式，则调用者必须提供服务器设置的访问用户名及密码的凭证