taobao.promotionmisc.tool.check (UMP工具检测)

UMP工具检测。ISV通过该接口检测(通过taobao.ump.tool.add)创建的UMP工具(tool)是否符合规范,如果不符合,则返回错误信息和对应的解决方案的;工具检测通过后才可以提交工具审核邮件,提交工具审核时,需提供该接口的返回值。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tool_id Number 必须 8745522
  • 最小值:10
  • 工具ID, taobao.ump.tool.add成功后返回的id。
    meta_allow String 可选 a1,c2,t1 可使用的元数据。PRD审核后,会告诉isv可使用的元数据。

    响应参数

    名称 类型 示例值 描述
    check_tool_module CheckToolModule - 工具审核结果。
    • └ is_pass
    • String
    • 工具是否检测通过。
    • └ error_message
    • String
    • (1) 元数据'打折'的'针对什么价格打折'参数类型应该为'RESOURCE , 获得订单的价格';
    • 工具检测结果中的错误信息。
    • └ meta_def
    • String
    • (1) 满多少元; (2) 减钱; (3) 打折; (4) 免邮;
    • 工具中已经使用的元数据。
    • └ check_url
    • String
    • checkTool?appKey=1015488940&toolId=874552234
    • 工具审核的URL,工具检测通过后,ISV需要把该URL和工具基本信息一起提交UMP工具技术审核。
    is_success Boolean true 工具检测动作是否成功。检测是否通过请查看返回值default_model里的is_pass。
    error_message String 接口调用出错信息 接口调用错误信息描述。

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    PromotionmiscToolCheckRequest req = new PromotionmiscToolCheckRequest();
    req.setToolId(8745522L);
    req.setMetaAllow("a1,c2,t1");
    PromotionmiscToolCheckResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <promotionmisc_tool_check_response>
        <check_tool_module>
            <is_pass>否</is_pass>
            <error_message>(1) 元数据&apos;打折&apos;的&apos;针对什么价格打折&apos;参数类型应该为&apos;RESOURCE , 获得订单的价格&apos;;</error_message>
            <meta_def>(1) 满多少元; (2) 减钱; (3) 打折; (4) 免邮;</meta_def>
            <check_url>checkTool?appKey=1015488940&amp;toolId=874552234</check_url>
        </check_tool_module>
        <is_success>true</is_success>
        <error_message>接口调用出错信息</error_message>
    </promotionmisc_tool_check_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>

    错误码解释

    错误码 错误描述 解决方案
    isv.tool-not-exist:toolId 查询不到工具,请检查输入的toolId是否正确。 检查toolId是否正确;检查当前的toolId是否是在当前的appkey下创建的。
    isp.tool-check-service-unavailable 工具检测异常。 稍后重试。

    API工具

    如何获得此API

    FAQ

    返回
    顶部