C300-OpenAPI

查询物料分类

POST

/api/open/v3/ITEM_CATEGORY/query

查询

请求参数

Path 参数

viewKey

string

必需

Body 参数application/json

conditions

object (ITEM_CATEGORY_filter)

可选

number

object

可选

物料分类编号(支持精确、集合查询)

code

object

可选

唯一编码(支持精确、集合查询)

parentId

object

可选

父级物料分类id(支持集合查询)

sorts

object (ITEM_CATEGORY_sort)

可选

fieldKeys

array[string]

可选

查询字段：为空则返回所有字段

paging

object

必需

start

integer

分页开始

必需

>= 0

length

integer

分页大小

必需

>= 1<= 500

示例

{
  "conditions": {
    "number": {
      "conditionType": "KEYWORD",
      "value": "string"
    },
    "code": {
      "conditionType": "KEYWORD",
      "value": "string"
    },
    "parentId": {
      "conditionType": "FILTER",
      "filter": [
        "string"
      ]
    }
  },
  "sorts": {},
  "fieldKeys": [
    "string"
  ],
  "paging": {
    "start": 0,
    "length": 1
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://c2.xinheyun.com/api/open/v3/ITEM_CATEGORY/query' \
--header 'Content-Type: application/json' \
--data-raw '{
    "conditions": {
        "number": {
            "conditionType": "KEYWORD",
            "value": "string"
        },
        "code": {
            "conditionType": "KEYWORD",
            "value": "string"
        },
        "parentId": {
            "conditionType": "FILTER",
            "filter": [
                "string"
            ]
        }
    },
    "sorts": {},
    "fieldKeys": [
        "string"
    ],
    "paging": {
        "start": 0,
        "length": 1
    }
}'

返回响应

🟢200成功

application/json

Body

code

integer

可选

message

string

可选

data

object

可选

list

array[object (ITEM_CATEGORY) {9}]

可选

start

integer

可选

length

integer

可选

recordsTotal

integer

可选

示例

{
  "code": 0,
  "message": "string",
  "data": {
    "list": [
      {
        "number": "string",
        "inventoryAccountType": "string",
        "code": "string",
        "createTime": 0,
        "snType": "string",
        "name": "string",
        "updateTime": 0,
        "inventoryCycleDays": 0,
        "parentId": 0
      }
    ],
    "start": 0,
    "length": 0,
    "recordsTotal": 0
  }
}

🟢201成功

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

查询物料分类列表

分批查询物料分类