找模板接口

#  找模板接口 `公开`

## 支持场景
>  营销模板，防伪模板，追溯模板，个人中心，积分商城

## API描述
>  API描述：根据数码信息、活动类型、指定模板id、指定活动id找模板

## 请求路径
-   请求路径：`/marketing/open/H5Template/v1/getTemplate`
-   请求方式： `POST`

## 公共参数
- 详见 [通用请求头](https://developers.yesno.com.cn/doc/56/)
在超8平台中申请第三方系统的应用Access Key和密钥（线下）。
第三方系统根据应用Access Key和密钥向系统发起Access Token申请【[如何获取token](https://developers.yesno.com.cn/doc/57/ "如何获取token")】。
三方系统调用防伪领域服务的开放接口进行数据对接。

## 请求参数
| 参数名称 | 参数类型 | 必须 | 参数说明 | 示例值 |
| --- | --- | --- | --- | --- |
| channel | integer | 是 | 入口类型（1解码入口；2地址入口；3外码入口），默认：1解码入口 |
| enterpriseNo | String | 否 | 企业号（外码模式和地址入口时传递） |
| activityId | integer | 否 | 活动Id（固定活动时传递） |
| activityType | integer | 否 | 活动类型 |
| targetPeople | string | 否 | 目标人群，多个用英文逗号分隔 |
| targetPeopleValue | string | 否 | 目标人群值，多个用英文逗号分隔 |
| platform | integer | 必须 | 平台类型，1h5；2小程序，默认：1 |
| lang | string | 必须 | 语言类型（中文：zh-cn） |
| digitCode | string | 非必须 | 数码，支持url形式数码 |
| decodeVer | string | 非必须 | 数码解码版本号 |
| sign | string | 非必须 | 防篡改签名（  1、去掉空参数后根据key以字母a到z的顺序排序 2、把参数所有元素，按照“参数=参数值”的模式用“&”字符拼接成字符串； 3、拼接：&key=秘钥；  4、摘要加密（生成16进制MD5小写模式字符串）；） |
| customParams | string | 非必须 | 自定义参数（参与验签），json格式。 外码参数： {"digitCodeType":"数码类型（1：防伪码，2：追溯码）","digitCodeLevel":"数码层级","productId":"商品Id","labelNo":"标签编号","productionCode":"生产批次","batchCode":"生码批次","logisticCode":"物流码","digitCodeIsActive":"数码激活状态（1已激活；0未激活）","codeStoreId":"数码最后一次流向门店Id","codeDealerId":"数码最后一次流向经销商Id","digitCodeObsolete":"数码是否作废：0正常数码，1作废"} |
| passParams | string | 非必须 | 自定义参数（不参与验签），json格式。 前置授权参数： {"gpsType":"用户定位经纬度类型","gps":"用户定位经纬度","provinceCode":"用户定位省份code","provinceName":"省名称","cityCode":"用户定位城市code","cityName":"市名称","areaCode":"用户定位区code","areaName":"区名称","address":"详细地址","weChatOpenId":"微信openId","weChatUnionId":"微信unionId","weChatNickname":"微信昵称"} **注意：****1、**gps，如果省市区code参数都没传值，那么会通过gps参数解析得到省市区code，此时必须要有gpsType参数，最终相关的活动规则会用到**2、**省code，相关的活动规则会用到。省市区code参数要么都传，要么都不传，如果都不传的话会通过gps参数去解析，只要省市区code其中一个参数有值就不会通过gps参数解析**3、**市code，相关的活动规则会用到。省市区code参数要么都传，要么都不传，如果都不传的话会通过gps参数去解析，只要省市区code其中一个参数有值就不会通过gps参数解析**4、**区code，相关的活动规则会用到。省市区code参数要么都传，要么都不传，如果都不传的话会通过gps参数去解析，只要省市区code其中一个参数有值就不会通过gps参数解析**5、**gps类型：0: bd09ll 百度经纬度坐标，1: bd09mc 百度摩卡托坐标，2: wgs84ll 基础的坐标，3: gcj02ll 国测局加密坐标 国内地图通用坐标类型。如果有GPS入参，那么此参数也要填写	 |

## 响应参数
| 参数名称 | 参数类型 | 参数说明 |
| --- | --- | --- |
| code | integer | 状态：200 成功 |
| message | String | 信息 |
| timestamp | Long | 时间戳 |
| traceId | String | 追踪id |
| data | Object | 响应对象 |

## data 对象
| 参数名称 | 参数类型 | 参数说明 |
| --- | --- | --- |
| needWeChatAuth | integer | 是否需要微信授权：（0否，1是） |
| needGpsAuth | integer | 是否需要GPS授权：（0否，1是） |
| codeBase | object | 数码信息对象 |
| h5Template | object | 模板对象 |

## codeBase 对象
| 参数名称 | 参数类型 | 参数说明 |
| --- | --- | --- |
| enterpriseNo | string | 企业号 |
| digitCode | string | 数码 |
| digitCodeType | integer | 数码类型（1：防伪码，2：追溯码） |
| digitCodeLevel | integer | 数码层级 |
| productId | string | 商品Id |
| labelNo | string | 标签号 |
| productionCode | string | 生产批次 |
| batchCode | string | 生码批次 |
| logisticCode | string | 物流码 |
| digitCodeIsActive | integer | 数码激活状态：（1已激活；0未激活） |
| codeStoreId | string | 数码最后一次流向门店Id |
| codeDealerId | string | 数码最后一次流向经销商Id |
| digitCodeObsolete | integer | 数码是否作废：0正常数码，1作废 |

## h5Template 对象
| 参数名称 | 参数类型 | 参数说明 |
| --- | --- | --- |
| entryType | integer | 模板来源类型：0超8模板，1第三方链接，3托管在超8上的自定义应用 |
| entryValue | string | 根据来源类型，存储具体入口内容 |
| templateVersionId | string | 模板版本Id |
| activityId | integer | 活动Id |
| activityName | string | 活动名称 |
| weChatAuthorized | integer | 微信授权方式：0隐式授权，1显示授权，2不授权 |
| activityType | string | 活动类型（1：防伪，2：追溯，3：营销活动） |
| gpsType | string | GPS获取方式：1精准定位，2模糊定位，3不定位 |
| officialAccounts | string | 公众号Id |
| runPlatform | string | 运行平台：(1h5，2小程序)，多选用逗号分割 |

## 返回码
| 返回码 | 描述 |  解决方案|
| --- | --- | --- | 
| 200 | 成功 |  |