1、食谱TOP接口申请

1.1 定向申请地址

说明：目前只允许企业号进行申请；
http://my.open.taobao.com/common/applyIsv.htm?appTag=212&accessCode=E9780D2AC20DD170450FDBF555F67E3E

1.2 淘宝合作伙伴开发协议

image.png

1.3 填写开发者信息

image.png

1.4 创建食谱应用

image.png

1.5 申请TOP接口

image.png
image.png

2、SDK使用说明

2.1 选择需要的SDK版本进行构建

image.png

2.2 下载SDK并引入代码——JAVA演示

2.2.1 项目引入SDK包

（1）在项目resources目录下创建lib目录，将SDK包导入到该目录下
image.png

（2）pom中引入本地jar包

  1.         <dependency>
  2.             <groupId>ailib-iot</groupId>
  3.             <artifactId>sdk-java-auto</artifactId>
  4.             <version>1576072385423-20200612</version>
  5.             <scope>system</scope>
  6.             <systemPath>${project.basedir}/src/main/resources/lib/taobao-sdk-java-auto_1576072385423-20200612.jar</systemPath>
  7.         </dependency>

2.3 食谱TOP接口调用——JAVA演示

2.3.1 插入或更新食谱测试

说明：返回结果是businessRecipeId 行业食谱id；

  1.     /**
  2.      * 插入或更新食谱测试
  3.      */
  4.     public static void insertOrUpdateRecipeTest() throws ApiException {
  5.         DefaultTaobaoClient client = new DefaultTaobaoClient("http://gw.api.taobao.com/router/rest", "30281416",
  6.                 "4f9918cxxxxxxxxxxxxx6debcebaa");
  7.         AlibabaAilabsIotBusinessRecipeInsertorupdateRequest request = new AlibabaAilabsIotBusinessRecipeInsertorupdateRequest();
  9.         // 接口参数
  10.         BusinessRecipeOpenParam businessRecipeOpenParam = new BusinessRecipeOpenParam();
  11.         // 开放账号id
  12.         businessRecipeOpenParam.setOpenAccountId("a2uDllguxxxxxxM3wkl+w==");
  13.         // 食谱类型 0视频菜谱 1图文菜谱
  14.         businessRecipeOpenParam.setRecipeType(1L);
  15.         // 品类Id
  16.         businessRecipeOpenParam.setDevTypeId(11L);
  17.         // 食谱中文名称
  18.         businessRecipeOpenParam.setRecipeNameCn("蜜瓜奶昔");
  19.         // 食谱描述
  20.         businessRecipeOpenParam.setDescription("蜜瓜富含膳食纤维，酸奶富含益生菌，两者均有助于肠道健康。");
  21.         // 食谱图片
  22.         ImageUrlParam recipeImage = new ImageUrlParam();
  23.         recipeImage.setImg("http://www.xxx.com");
  24.         businessRecipeOpenParam.setRecipeImage(recipeImage);
  25.         // 食谱食材
  26.         List<RecipeIngredientParam> recipeIngredientList = new ArrayList<>();
  27.         RecipeIngredientParam recipeIngredientParam1 = new RecipeIngredientParam();
  28.         recipeIngredientParam1.setName("蜜瓜");
  29.         recipeIngredientParam1.setWeight("300g");
  30.         recipeIngredientList.add(recipeIngredientParam1);
  31.         RecipeIngredientParam recipeIngredientParam2 = new RecipeIngredientParam();
  32.         recipeIngredientParam2.setName("酸奶");
  33.         recipeIngredientParam2.setWeight("300g");
  34.         recipeIngredientList.add(recipeIngredientParam2);
  35.         businessRecipeOpenParam.setRecipeIngredientList(recipeIngredientList);
  36.         request.setParamBusinessRecipeOpenParam(businessRecipeOpenParam);
  38.         // 通用参数
  39.         request.setTimestamp(System.currentTimeMillis());
  40.         request.setTopApiVersion("2.0");
  41.         request.setTopContentType("application/json");
  42.         request.setTopHttpMethod("alibaba.ailabs.iot.business.recipe.insertorupdate");
  43.         request.setTopResponseType("application/json");
  45.         // 接口调用
  46.         AlibabaAilabsIotBusinessRecipeInsertorupdateResponse response = client.execute(request);
  47.         if (response.isSuccess()) {
  48.             System.out.println(response.getBody());
  49.         }
  50.     }

2.3.2 插入或更新食谱步骤测试

说明：返回的是businessRecipeStepId 行业食谱步骤id；

  1.     /**
  2.      * 插入或更新食谱步骤测试
  3.      */
  4.     public static void insertOrUpdateRecipeStepTest() throws ApiException {
  5.         DefaultTaobaoClient client = new DefaultTaobaoClient("http://gw.api.taobao.com/router/rest", "30281416",
  6.                 "4f9918cxxxxxxxxxxxxx6debcebaa");
  7.         AlibabaAilabsIotBusinessRecipestepInsertorupdateRequest request = new AlibabaAilabsIotBusinessRecipestepInsertorupdateRequest();
  9.         // 接口参数
  10.         BusinessRecipeStepOpenParam businessRecipeStepOpenParam = new BusinessRecipeStepOpenParam();
  11.         // 开放账号Id
  12.         businessRecipeStepOpenParam.setOpenAccountId("a2uDllguxxxxxxM3wkl+w==");
  13.         // 行业食谱id
  14.         businessRecipeStepOpenParam.setBusinessRecipeId(6L);
  15.         // 指令标识：0不支持指令，1支持指令
  16.         businessRecipeStepOpenParam.setActionFlag(1L);
  17.         // 食谱步骤中文名
  18.         businessRecipeStepOpenParam.setRecipeStepNameCn("开始制作");
  19.         // 食谱步骤描述
  20.         businessRecipeStepOpenParam.setDescription("根据食谱称量口口蜜瓜块，然后放入研磨腔内，并加入3杯（300g）酸奶，选择“奶昔”功能键，点击“启动”即可");
  21.         // 食谱步骤顺序号
  22.         businessRecipeStepOpenParam.setSequence(1L);
  23.         // 食谱步骤图片
  24.         com.taobao.api.request.AlibabaAilabsIotBusinessRecipestepInsertorupdateRequest.ImageUrlParam imageUrl = new com.taobao.api.request.AlibabaAilabsIotBusinessRecipestepInsertorupdateRequest.ImageUrlParam();
  25.         imageUrl.setImg("http://www.xxx.com");
  26.         businessRecipeStepOpenParam.setImageUrl(imageUrl);
  27.         // 食谱步骤时间
  28.         businessRecipeStepOpenParam.setRecipeStepTime(180L);
  29.         businessRecipeStepOpenParam.setTips("请检查食材是否都放入研磨腔内");
  30.         // 步骤指令列表
  31.         List<BusinessRecipeStepActionOpenParam> recipeStepActionList = new ArrayList<>();
  32.         BusinessRecipeStepActionOpenParam businessRecipeStepActionOpenParam1 = new BusinessRecipeStepActionOpenParam();
  33.         //   指令名
  34.         businessRecipeStepActionOpenParam1.setActionName("runTime");
  35.         //   指令值
  36.         businessRecipeStepActionOpenParam1.setActionValue("180");
  37.         //   指令顺序号
  38.         businessRecipeStepActionOpenParam1.setSequence(1L);
  39.         recipeStepActionList.add(businessRecipeStepActionOpenParam1);
  40.         BusinessRecipeStepActionOpenParam businessRecipeStepActionOpenParam2 = new BusinessRecipeStepActionOpenParam();
  41.         //   指令名
  42.         businessRecipeStepActionOpenParam2.setActionName("recipeAction");
  43.         //   指令值
  44.         businessRecipeStepActionOpenParam2.setActionValue("2191000151000330031E50000530031E500005700000");
  45.         //   指令顺序号
  46.         businessRecipeStepActionOpenParam2.setSequence(2L);
  47.         recipeStepActionList.add(businessRecipeStepActionOpenParam2);
  48.         businessRecipeStepOpenParam.setRecipeStepActionList(recipeStepActionList);
  49.         request.setParamBusinessRecipeStepOpenParam(businessRecipeStepOpenParam);
  51.         // 通用参数
  52.         request.setTimestamp(System.currentTimeMillis());
  53.         request.setTopApiVersion("2.0");
  54.         request.setTopContentType("application/json");
  55.         request.setTopHttpMethod("alibaba.ailabs.iot.business.recipe.insertorupdate");
  56.         request.setTopResponseType("application/json");
  58.         // 接口调用
  59.         AlibabaAilabsIotBusinessRecipestepInsertorupdateResponse response = client.execute(request);
  60.         if (response.isSuccess()) {
  61.             System.out.println(response.getBody());
  62.         }
  63.     }

2.3.3 获取食谱分页数据

说明：返回结果是用户维度的食谱概要数据；

  1. /**
  2.      * 获取食谱分页数据
  3.      * 
  4.      * @throws ApiException
  5.      */
  6.     public static void getRecipePageTest() throws ApiException {
  7.         DefaultTaobaoClient client = new DefaultTaobaoClient("http://gw.api.taobao.com/router/rest", "30281416",
  8.                 "4f9918cxxxxxxxxxxxxx6debcebaa");
  9.         AlibabaAilabsIotBusinessRecipeGetpageRequest request = new AlibabaAilabsIotBusinessRecipeGetpageRequest();
  11.         // 开放账号id
  12.         request.setOpenAccountId("a2uDllguxxxxxxM3wkl+w==");
  13.         // 分页页数
  14.         request.setPageNum(1L);
  15.         // 分页大小
  16.         request.setPageSize(10L);
  18.         // 通用参数
  19.         request.setTimestamp(System.currentTimeMillis());
  20.         request.setTopApiVersion("2.0");
  21.         request.setTopContentType("application/json");
  22.         request.setTopHttpMethod("alibaba.ailabs.iot.business.recipe.getdetail");
  23.         request.setTopResponseType("application/json");
  25.         // 接口调用
  26.         AlibabaAilabsIotBusinessRecipeGetpageResponse response = client.execute(request);
  27.         if (response.isSuccess()) {
  28.             System.out.println(response.getBody());
  29.         }
  30.     }

2.3.4 获取食谱详情数据

  1.     /**
  2.      * 获取食谱详情测试
  3.      * 
  4.      * @throws ApiException
  5.      */
  6.     public static void getRecipeDetailTest() throws ApiException {
  7.         DefaultTaobaoClient client = new DefaultTaobaoClient("http://gw.api.taobao.com/router/rest", "30281416",
  8.                 "4f9918cxxxxxxxxxxxxx6debcebaa");
  9.         AlibabaAilabsIotBusinessRecipeGetdetailRequest request = new AlibabaAilabsIotBusinessRecipeGetdetailRequest();
  11.         // 开放账号id
  12.         request.setOpenAccountId("a2uDllguxxxxxxM3wkl+w==");
  13.         // 食谱id
  14.         request.setBusinessRecipeId(1L);
  16.         // 通用参数
  17.         request.setTimestamp(System.currentTimeMillis());
  18.         request.setTopApiVersion("2.0");
  19.         request.setTopContentType("application/json");
  20.         request.setTopHttpMethod("alibaba.ailabs.iot.business.recipe.getdetail");
  21.         request.setTopResponseType("application/json");
  23.         // 接口调用
  24.         AlibabaAilabsIotBusinessRecipeGetdetailResponse response = client.execute(request);
  25.         if (response.isSuccess()) {
  26.             System.out.println(response.getBody());
  27.         }
  28.     }

3、补充文档

3.1 TOP接口操作文档

https://open.taobao.com/doc.htm?docId=101617&docType=1

3.2 OpenAccountId问题

请提供IOT开放平台账号邮箱给小二，由小二生成给到ISV；

3.3 厨电品类文档

https://www.aligenie.com/doc/357554/hiku59

3.4 食谱标签文档

https://www.aligenie.com/doc/357554/xum3re