对生产过程中的成品和半成品的质检结果进行管理,此接口查询已存在的质检结果记录列表

路径 /industry/qualitytrace/qualitycontrol/query
版本号 1.0.1
协议 HTTPS
请求方法 POST
是否需要用户身份鉴权
超时时间 5000

请求参数

名称 类型 是否必选 示例值 描述
search String 根据唯一码或者物料编码搜索
startTime String "startTime":"2019-09-25 00:00:00" 根据时间查找,startTime和endTime必须组合使用
endTime String "endTime":"2019-09-25 00:00:01" 根据时间段查找质检记录,startTime和endTime组合使用
pageId Int {"pageId":1} 按页获取,指定目标页码,起始值为1
pageSize Int {"pageSize":1500} 指定每页行数
appId String 应用id,saas的共享应用需要传这个值
employeeId String 用户id,需要做用户级别鉴权时需要传入此参数
corpId String 企业标识,每个企业拥有唯一的CorpID,比如钉钉corpID、LH里面的appId,用参数source来区分参数含义
userId String 员工在当前企业内的唯一标识,比如钉钉userId或者IoT的employeeId
source String 参数来源,枚举值,钉钉填写DINGDING,多租户saas应用填SAAS,source、corpId、userId配合使用

返回数据

名称 类型 示例值 描述
code Int

响应码, 200: 成功

message String

错误消息

localizedMsg String

本地语言错误消息

data JSON

响应结果

record JSON

质检记录列表

id Long

质检记录id

uniqueCode String

质检记录唯一码

stepCode String

质检记录步骤编码

stepTree String

步骤树,根据 "工艺路径/工序/步骤" 的格式返回步骤的层级信息

startTime String

质检记录开始时间

endTime String

质检记录结束时间

outPut Double

质检总量

verifiedOutPut Double

已检验产量

checkerId Long

质检员id,这里是人员主数据id

checkerName String

检验员名称

materialCode String

物料主数据编码

materialName String

物料主数据名称

createTime String

创建时间

modifyTime String

更新时间

page JSON

查询结果的分页信息

pageId Int

查询结果所在的页号

pageSize Int

查询结果的页大小

total Long

总的数据量

示例

请求示例

// https://github.com/aliyun/iotx-api-gateway-client
IoTApiClientBuilderParams ioTApiClientBuilderParams = new IoTApiClientBuilderParams();

ioTApiClientBuilderParams.setAppKey("你的<AppKey>");
ioTApiClientBuilderParams.setAppSecret("你的<AppSecret>");

SyncApiClient syncApiClient = new SyncApiClient(ioTApiClientBuilderParams);

IoTApiRequest request = new IoTApiRequest();

// 设置请求ID
String uuid = UUID.randomUUID().toString();
String id = uuid.replace("-", "");
request.setId(id);
// 设置API版本号
request.setApiVer("1.0.1");

// 设置参数
request.putParam("search", "value0");
request.putParam("startTime", value1");
request.putParam("endTime", value2");
request.putParam("pageId", value3");
request.putParam("pageSize", value4");
request.putParam("appId", value5");
request.putParam("employeeId", value6");
request.putParam("corpId", value7");
request.putParam("userId", value8");
request.putParam("source", value9");
// 如果需要,设置headers
Map<String, String> headers = new HashMap<String, String>(8);
// headers.put("你的<header", "你的<value>");

// 设置请求参数域名, path, request, isHttps, headers
ApiResponse response = syncApiClient.postBody("api.link.aliyun.com", "/industry/qualitytrace/qualitycontrol/query", request, true, headers);

System.out.println(
    "response code = " + response.getCode()
        + " response = " + new String(response.getBody(), "UTF-8")
        + " headers = " + response.getHeaders().toString()
);

正常返回示例

JSON 格式

{
  "id": "4de2c367-c1db-417c-aa15-8c585e595d92",
  "code": 200,
  "message": null,
  "localizedMsg": null,
  "data": {
    "record": [
      {
        "id": 57,
        "uniqueCode": "D11122",
        "stepCode": "A001",
        "stepName": "支付宝工序步骤001",
        "stepTree": "OC创建支付宝工艺路径/支付宝工艺001/支付宝工序步骤001",
        "startTime": "2019-08-01 00:00:00",
        "endTime": "2019-08-06 00:00:00",
        "outPut": 20,
        "verifiedOutPut": 20,
        "checkerId": 1,
        "checkerName": null,
        "materialCode": "w0001",
        "materialName": null,
        "createTime": "2019-08-06 20:20:54",
        "modifyTime": "2019-08-06 20:20:54"
      },
      {
        "id": 53,
        "uniqueCode": "R0001",
        "stepCode": "A001",
        "stepName": "支付宝工序步骤001",
        "stepTree": "OC创建支付宝工艺路径/支付宝工艺001/支付宝工序步骤001",
        "startTime": "2019-07-14 04:04:00",
        "endTime": "2019-07-16 06:06:00",
        "outPut": 1000,
        "verifiedOutPut": 1000,
        "checkerId": 1,
        "checkerName": null,
        "materialCode": "w0001",
        "materialName": null,
        "createTime": "2019-07-16 10:58:37",
        "modifyTime": "2019-07-16 10:58:37"
      }
    ],
    "page": {
      "pageId": 1,
      "pageSize": 15,
      "total": 2
    }
  },
  "success": true
}

异常返回示例

JSON 格式

{
    "id": "37f7e5fa-d6a5-4efe-8abf-5bf23dca6284",
    "code": 403,
    "message": "request forbidden.",
    "localizedMsg": "请求被禁止",
    "data": null
}

错误码

HttpCode 错误码 错误信息 描述
500 500 Internal Error Internal Error
503 503 Service Unavailable Service Unavailable
403 403 Request Limited Request Limited
401 401 Empty Signature Empty Signature
400 400 Request Format Error Request Format Error
200 20003 Find Backend Error Find Backend Error
200 20004 Backend Service Error Backend Service Error
200 20055 Backend Service Invalid Request Format Error
200 20056 Hsf Invoke Timeout Hsf Invoke Timeout
200 401 Request Authorized Error Request Authorized Error
200 403 Request Forbidden Request Forbidden
200 500 Server Error Server Error
200 500 server error. 系统错误
200 403 request forbidden. 请求被禁止
200 460 request parameter error. 请求参数错误
200 403 request forbidden. 请求被禁止
200 460 request parameter error. 请求参数错误
200 500 server error. 系统错误
200 403 request forbidden. 请求被禁止
200 460 request parameter error. 请求参数错误
200 500 server error. 系统错误
200 500 server error. 系统错误
200 403 request forbidden. 请求被禁止
200 460 request parameter error. 请求参数错误
200 403 request forbidden. 请求被禁止
200 460 request parameter error. 请求参数错误
200 500 server error. 系统错误
200 500 server error. 系统错误
200 460 request parameter error. 请求参数错误
200 403 request forbidden. 请求被禁止
200 22000 Query Result is Empty 查询结果为空
200 460 request parameter error. 请求参数错误
200 500 server error. 系统错误
200 403 request forbidden. 请求被禁止
200 460 request parameter error. 请求参数错误
200 500 server error. 服务错误
200 460 request parameter error. 请求参数错误
200 403 request forbidden. 请求被禁止
200 500 server error. 系统错误
200 460 request parameter error. 请求参数错误
200 403 request forbidden. 请求被禁止
200 500 server error. 系统错误
200 500 server error. 系统错误
200 460 request parameter error. 请求参数错误
200 403 request forbidden. 请求被禁止
200 403 request forbidden. 请求被禁止
200 460 request parameter error. 请求参数错误
200 500 server error. 系统错误