跳到主要内容

查询特征资料

【基本信息】​

信息值备注
接口名称查询特征资料分页查询特征资料，默认按EFF_DD倒序
请求状态POSTRESTful方式
接口路径http://localhost:23798/api/Mark/List向服务器地址发送POST请求
远程模式http://www.linkerplus.com/api/ext_erp/Mark/List远程模式向服务器地址发送POST请求，需要ERP注册号注册远程模式，并在Headers添加sn参数

【请求参数】​

Headers

参数名称是否必须参数值备注
Content-Type是application/json用于指定数据的传输类型
LoginId是e835943e-55c2-4bf0-832d-6f4166592941用户登录的LoginId，取用户登录或账套验证接口返回的LoginId
sn否MGR_REST_1001远程模式需添加sn参数，MGR_REST_+ERP注册号

Body

参数名称类型是否必须参数值备注
CURRENT_PAGEint是1当前页码，表示返回该页数据
PAGE_SIZEint否100每页数据数量，默认【100】，值在【1-1000】中选择，传其它值会取默认值
USR_NOstring否用户代号。账套验证的LoginId需添加USR_NO，用户登录的LoginId则无需添加USR_NO
FILTERobject否见下方详细说明过滤条件
ORDER_BYobject否有值时：{"PRD_MARK":"DESC","MARK_NO":"ASC"}排序条件。按PRD_MARKS表中栏位自动匹配，为空时按EFF_DD倒序。 DESC：降序、ASC：升序
### FILTER ###
{
    "START_DD": "", //查询EFF_DD大于该时间的数据（可用于同步特征资料数据），格式为yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss
    "MARK_NO_B": "", // 起始特征组代号
    "MARK_NO_E": "", // 截止特征组代号
    "MARK_NAME": "", // 特征组名称，模糊匹配
    "PRD_MARK": "" // 特征，模糊匹配
}

【返回数据】​

参数名称类型参数值备注
codeint0：表示查询成功。 1：表示查询失败。
messagestring执行信息
resultobject查询到的信息，JSON格式，具体信息参考下面调用范例

【调用范例】​

请求：

{
    "CURRENT_PAGE": 1, //必填，当前第几页
    "PAGE_SIZE": 1, //选填，默认每页100，可传1-1000
    "USR_NO": "ADMIN", //账套验证的LoginId需添加USR_NO，用户登录的LoginId则无需添加
    "FILTER": {//选填
        "START_DD": "", //查询EFF_DD大于该时间的数据（可用于同步特征资料数据），格式为yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss
        "MARK_NO_B": "", // 起始特征组代号
        "MARK_NO_E": "", // 截止特征组代号
        "MARK_NAME": "", // 特征组名称，模糊匹配
        "PRD_MARK": "" // 特征，模糊匹配
    },
    "ORDER_BY": {} //选填，排序条件，按PRD_MARKS表栏位自动匹配，默认以EFF_DD倒序，使用此接口同步最新资料时，需记录第一页第一条数据的EFF_DD
}

返回：

{
    "code":0,
    "message":"查询成功。",
    "result":{
        "total": 99,
        "total_page": 99,
        "current_total": 1,
        "current_page": 1,
        "page_size": 1,
        "has_pre": false,
        "has_next": true,
        "data": [
            {
              "MARK_NO": "1", //特征组代号
              "PRD_MARK": "212", //特征
              "MARK_NAME": "111", //特征组名称
              "REM": "jbkjj" //备注
            }
        ]
    }
}

【备注】​

必须在Headers里面传入用户登录或账套验证的LoginId。

使用该接口同步特征资料的建议

排序条件不用填，第一次调用后，记录第1页第一项数据的EFF_DD，作为下一次调用的FILTER中的START_DD的传值，若下一次调用有数据返回，则表示有特征数据更新或者新增，通过此方法可获取全部特征数据。

EFF_DD为空未审核数据不返回。