k3proxy服务使用说明

接口鉴权与统一响应说明

见文档：https://apifox.com/apidoc/shared-b7075533-cffe-403f-9c67-ecda25d00270

同步与异步接口

提供同步与异步接口，同步接口返回结果，异步接口直接返回任务id，随后通过任务id查询结果

同步接口

数据的查询操作，推荐使用同步接口，同步接口返回查询结果。

异步接口

数据的增删改操作，推荐使用异步接口，异步接口返回任务id，随后通过任务id查询结果。

服务地址

环境	请求地址
开发	暂无
SIT测试	http://fms2-sit.linshimuye.com/k3proxy/
UAT测试	http://fms2-uat.linshimuye.com/k3proxy/
正式	http://fms2.linshimuye.com/k3proxy/

请求参数说明

参数	参数名	类型	是否必填	描述
formId	表单id	String	是	通过金蝶客户端webapi查看各表单id
operateType	操作类型	String	是	通过金蝶客户端webapi查看各操作key(有一个特殊的operateType：SaveAutoSubmitAudit。该operateType不是金蝶标准的，是进行了一层封装的会在保存单据后自动进行提交与审核操作)
data	数据	String	是	通过金蝶客户端webapi查看各操作数据格式
appKey	调用方appKey	String	是

请求示例

以同步接口方式，“获取店铺列表”为例

先计算签名，然后把签名相关字段放入queryString中

url: http://fms2-sit.linshimuye.com/k3proxy/open/v1/syncInvoke?apiKey=IECM&timestamp=1689079335613&sign=7e0fb3020d17ee0b9f6b2f0e71bb78da

请求体：

{
    "operateType": "ExecuteBillQuery",
    "appKey": "IECM",
    "formId": "LS_Shop",
    "data": "{\"FormId\":\"LS_Shop\",\"FieldKeys\":\"FID,FNumber,FName\",\"FilterString\":\"FDocumentStatus = 'C' and FForbidStatus = 'A' and FNAME like '东莞%') > 0\",\"Limit\":20}"
}

响应体：

{
    "data": "[[523071,\"10001\",\"广州番禺经销店\"],[523072,\"10002\",\"深圳宝安经销店\"],[523073,\"10003\",\"成都双流经销店\"],[523074,\"10004\",\"长沙长沙县经销店\"],[523075,\"10005\",\"蚌埠市淮上区经销店\"],[523076,\"10006\",\"济宁市任城区经销店\"],[523077,\"10007\",\"中山富港经销店\"],[523078,\"10008\",\"沈阳金卡经销店\"],[523079,\"10009\",\"商丘梁园经销店\"],[523080,\"10010\",\"济南天桥经销店\"],[523081,\"10011\",\"开封鼓楼经销店\"],[523082,\"10012\",\"四川宜宾经销店\"],[523083,\"10013\",\"昆明官渡经销店\"],[523084,\"10014\",\"苏州昆山经销店\"],[523085,\"10015\",\"东莞寮步经销店\"],[523086,\"10016\",\"湖南株洲经销店\"],[523087,\"10017\",\"安徽宿州经销店\"],[523088,\"10018\",\"芜湖镜湖经销店\"],[523089,\"10019\",\"温州乐清经销店\"],[523090,\"10020\",\"潍坊奎文经销店\"]]",
    "isSuccess": true,
    "message": "成功",
    "errorCode": 0,
    "detailMessage": null
}

注意：data字段为金蝶标准api返回的数据，不一定是json格式，需要根据具体接口文档解析

使用说明

k3proxy服务使用说明#

接口鉴权与统一响应说明#

同步与异步接口#

同步接口#

异步接口#

服务地址#

请求参数说明#

请求示例#

k3proxy服务使用说明

接口鉴权与统一响应说明

同步与异步接口

同步接口

异步接口

服务地址

请求参数说明

请求示例