当前位置： API文档

goods_category_query.php（查询货品分类）

¥基础   ¥增值  ¥定制

1.接口说明


1.1 接口描述：获取租户系统内全部货品分类的id、分类名词和分类的层级关系
1.2 适用版本：250520迭代及之后
1.4 时间跨度：开始时间和结束时间取值范围为闭区间取值，例如2018-11-01 00:00:00至2018-11-30 23:59:59，建议根据获取数据量的多少适当减小时间跨度。


2.调用场景


2.1 举例说明： SAP、线下ERP、SRM、SCM等系统对接


3.请求参数说明

   3.1 请求地址


环境HTTP地址
测试环境https://openapi.ali.huice.cc/openapi/goods_category_query.php
正式环境https://openapi.huice.com/openapi/goods_category_query.php


   3.2 公共请求参数


名称字段类型长度
必须描述
卖家账号sidString
是购买ERP时由旺店通分配给ERP购买方，请从ERP购买方获取。
接口账号appkeyString
是本开放平台“自助对接”功能模块内自助申请，申请流程单击这里
时间戳timestampint
是北京时间1970-01-01 08:00:00起至现在的总秒数，10位int值,旺店通企业版API服务端允许请求最大时间误差为5min，date.timezone = Asia/Shanghai。
签名signString
是API输入参数签名结果，签名算法介绍单击这里

   

4.响应参数


   4.1 公共响应参数


名称字段类型长度
必须描述
错误码codeint11是状态码:0表示成功,其他表示失败
错误描述messagevarchar255是错误描述
一级分类列表goods_category_listdata[]
是响应参数的1级数据节点，包含一级分类及其子分类，节点下数据字段详见下述" goods_category_list"和“children_list” 

   

4.2 业务响应参数

    goods_category_list

名称字段类型长度
必须描述
分类ididbigint(20)
是货品分类id 
分类名称category_namevarchar40是货品分类名称 
分类下面的子分类children_listdata[] 40是子分类包含内容和goods_category_list一致

5.请求示例

PHP
<?php
    require_once '../WdtClient.php';
    $c = new WdtClient;
    $c->sid ='';
    $c->appkey ='';
    $c->appsecret ="";
    //测试环境地址
    //上线时需要换成线上的
 
    $c->gatewayUrl = 'https://openapi.ali.huice.cc/openapi/goods_category_query.php';
   // $c->gatewayUrl = 'https://openapi.huice.com/openapi/goods_category_query.php';


    $json = $c->wdtOpenApi();
    var_dump($json);
?>
JAVA
C#
python

6.响应示例

   6.1 正常响应示例 

JSON
{
    "code": 200,
    "message": null,
    "goods_category_list": [
        {
            "id": "2788804529557078030",
            "category_name": "测试分类第一级",
            "children_list": [
                {
                    "id": "2788804569222610958",
                    "category_name": "分类二级",
                    "children_list": [
                        {
                            "id": "2788804604446375950",
                            "category_name": "分类三级",
                            "children_list": null
                        }
                    ]
                }
            ]
        }
    ]
}

   6.2 异常响应示例

JSON







常用工具