跳到主要内容

查询特征资料

基本信息​

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

请求参数​

Headers

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

Body

参数名称类型是否必须参数值备注
CURRENT_PAGEnumber是1当前页码，表示返回该页数据
PAGE_SIZEnumber否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": "" // 特征，模糊匹配
}

返回数据​

参数名称类型参数值备注
codenumber0：表示查询成功。 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。
  • EFF_DD 为空未审核数据不返回。
使用该接口同步特征资料的建议

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