文档中心 > API类目 > 天猫精灵开放API

alibaba.ailabs.aligenie.skill.entity.import (实体动态更新)

根据用户上传的实体信息,进行制定技能实体的动态变更

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
skill_id Number 必须 1234 技能Id
append Boolean 可选 true
  • 默认值:true
  • 是否增量更新,true为增量,否则上传数据中没有的实体值将被删除
    test Boolean 可选 false
  • 默认值:false
  • 测试,目前没有此功能,此参数无效
    type String 可选 ISV
  • 默认值:ISV
  • 固定值,ISV
    entity_name String 必须 entity 要更新的实体名
    file_data byte[] 必须 [] 文件内容

    响应参数

    名称 类型 示例值 描述
    result BaseResult 返回包装类
    • ret_value
    • SimpleTextImportResult
    • 实体更新结果对象
    • └ num_exist
    • Number
    • 6
    • 已存在或重复的实体数
    • └ num_failed
    • Number
    • 2
    • 上传失败的实体数
    • └ num_successful
    • Number
    • 2
    • 上传成功的实体数
    • └ ret_code
    • Number
    • 1
    • 服务返回错误码
    • └ ret_msg
    • String
    • success
    • 服务返回错误信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaAilabsAligenieSkillEntityImportRequest req = new AlibabaAilabsAligenieSkillEntityImportRequest();
    req.setSkillId(1234L);
    req.setAppend(true);
    req.setTest(false);
    req.setType("ISV");
    req.setEntityName("entity");
    req.setFileData(new FileItem("/tmp/file.txt"));
    AlibabaAilabsAligenieSkillEntityImportResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_ailabs_aligenie_skill_entity_import_response>
        <result>
            <ret_value>
                <num_exist>6</num_exist>
                <num_failed>2</num_failed>
                <num_successful>2</num_successful>
            </ret_value>
            <ret_code>1</ret_code>
            <ret_msg>success</ret_msg>
        </result>
    </alibaba_ailabs_aligenie_skill_entity_import_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部