海心下游对接接口文档


产品信息查询

<h5>简要描述</h5> <ul> <li>查询已配置产品信息</li> </ul> <h5>请求URL</h5> <ul> <li><code>http://ip:port/userProduct/query</code></li> </ul> <h5>请求方式</h5> <ul> <li>POST </li> <li>application/json;charset=UTF-8 </li> </ul> <h5>请求参数说明</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String</td> <td>签名,MD5(userId+key)</td> </tr> <tr> <td style="text-align: left;">productType</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Integer</td> <td>业务类型,枚举见文档底部</td> </tr> <tr> <td style="text-align: left;">faceValue</td> <td style="text-align: left;">否</td> <td style="text-align: left;">BigDecimal</td> <td>面额</td> </tr> <tr> <td style="text-align: left;">productOperator</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td>产品运营商,枚举见文档底部</td> </tr> </tbody> </table> <h5>请求示例</h5> <pre><code>{     &amp;quot;sign&amp;quot;:&amp;quot;d653bc1fc21e412bbe775473e2041f0e&amp;quot;, &amp;quot;productType&amp;quot;:&amp;quot;1&amp;quot; }</code></pre> <h5>返回参数说明</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">code</td> <td style="text-align: left;">Integer</td> <td>返回结果码,200查询成功</td> </tr> <tr> <td style="text-align: left;">msg</td> <td style="text-align: left;">String</td> <td>返回结果信息</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">Map</td> <td>数据集合,提单成功返回</td> </tr> <tr> <td style="text-align: left;">data. productType</td> <td style="text-align: left;">Integer</td> <td>业务类型,枚举见文档底部</td> </tr> <tr> <td style="text-align: left;">data. productTypeName</td> <td style="text-align: left;">String</td> <td>业务类型名称</td> </tr> <tr> <td style="text-align: left;">data. productId</td> <td style="text-align: left;">Integer</td> <td>产品id</td> </tr> <tr> <td style="text-align: left;">data. productOperator</td> <td style="text-align: left;">Integer</td> <td>产品运营商,枚举见文档底部</td> </tr> <tr> <td style="text-align: left;">data. productOperatorName</td> <td style="text-align: left;">String</td> <td>产品运营商名称</td> </tr> <tr> <td style="text-align: left;">data. faceValue</td> <td style="text-align: left;">BigDecimal</td> <td>面额</td> </tr> <tr> <td style="text-align: left;">data. unit</td> <td style="text-align: left;">String</td> <td>单位</td> </tr> <tr> <td style="text-align: left;">data. discount</td> <td style="text-align: left;">BigDecimal</td> <td>折扣,最多保留4位小数</td> </tr> <tr> <td style="text-align: left;">data. checkPrice</td> <td style="text-align: left;">BigDecimal</td> <td>结算金额,最多保留4位小数</td> </tr> <tr> <td style="text-align: left;">data. status</td> <td style="text-align: left;">Integer</td> <td>状态,1启用,0维护</td> </tr> <tr> <td style="text-align: left;">data. provinceType</td> <td style="text-align: left;">Integer</td> <td>分省类型,0全国,1分省(用于话费、流量业务)</td> </tr> <tr> <td style="text-align: left;">data. enableRegions</td> <td style="text-align: left;">String</td> <td>使用地区限制,多个逗号隔开,空表示不限制(用于话费、流量业务)</td> </tr> <tr> <td style="text-align: left;">data. disableRegions</td> <td style="text-align: left;">String</td> <td>禁用地区限制,多个逗号隔开,空表示不限制(用于话费、流量业务)</td> </tr> </tbody> </table> <h5>返回示例</h5> <pre><code>{     &amp;quot;code&amp;quot;: 200,     &amp;quot;msg&amp;quot;: &amp;quot;操作成功&amp;quot;,     &amp;quot;data&amp;quot;: [         {             &amp;quot;productType&amp;quot;: &amp;quot;1&amp;quot;,             &amp;quot;productTypeName&amp;quot;: &amp;quot;话费&amp;quot;,             &amp;quot;productId&amp;quot;: &amp;quot;10232&amp;quot;,             &amp;quot;productName&amp;quot;: &amp;quot;全国联通10元&amp;quot;,             &amp;quot;productOperator&amp;quot;: &amp;quot;1&amp;quot;,             &amp;quot;productOperatorName&amp;quot;: &amp;quot;移动&amp;quot;,             &amp;quot;provinceType&amp;quot;: &amp;quot;0&amp;quot;,             &amp;quot;faceValue&amp;quot;: 10,             &amp;quot;unit&amp;quot;: &amp;quot;元&amp;quot;,             &amp;quot;discount&amp;quot;: 0.98,             &amp;quot;checkPrice&amp;quot;: 9.8,             &amp;quot;status&amp;quot;: &amp;quot;1&amp;quot;         },         {             &amp;quot;productType&amp;quot;: &amp;quot;1&amp;quot;,             &amp;quot;productTypeName&amp;quot;: &amp;quot;话费&amp;quot;,             &amp;quot;productId&amp;quot;: &amp;quot;10017&amp;quot;,             &amp;quot;productName&amp;quot;: &amp;quot;1-联通10元&amp;quot;,             &amp;quot;productOperator&amp;quot;: &amp;quot;1&amp;quot;,             &amp;quot;productOperatorName&amp;quot;: &amp;quot;移动&amp;quot;,             &amp;quot;provinceType&amp;quot;: &amp;quot;1&amp;quot;,             &amp;quot;faceValue&amp;quot;: 10,             &amp;quot;unit&amp;quot;: &amp;quot;元&amp;quot;,             &amp;quot;discount&amp;quot;: 0.9,             &amp;quot;checkPrice&amp;quot;: 9,             &amp;quot;enableRegions&amp;quot;: &amp;quot;广东省,广西省&amp;quot;,             &amp;quot;disableRegions&amp;quot;: &amp;quot;云南省,西藏自治区&amp;quot;,             &amp;quot;status&amp;quot;: &amp;quot;1&amp;quot;         }     ],     &amp;quot;success&amp;quot;: true } </code></pre> <ul> <li>错误码</li> </ul> <table> <thead> <tr> <th style="text-align: left;">错误码</th> <th style="text-align: left;">注释</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">200</td> <td style="text-align: left;">查询成功</td> </tr> <tr> <td style="text-align: left;">412</td> <td style="text-align: left;">白名单校验失败</td> </tr> <tr> <td style="text-align: left;">422</td> <td style="text-align: left;">验签失败(请检查加签参数与顺序是否正确)</td> </tr> <tr> <td style="text-align: left;">500</td> <td style="text-align: left;">服务异常(请检查请求方式,参数格式,类型是否正确)</td> </tr> </tbody> </table> <ul> <li>产品业务类型(productType),枚举</li> </ul> <table> <thead> <tr> <th style="text-align: left;">业务类型</th> <th style="text-align: left;">名称</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">1</td> <td style="text-align: left;">话费</td> </tr> <tr> <td style="text-align: left;">2</td> <td style="text-align: left;">流量</td> </tr> <tr> <td style="text-align: left;">3</td> <td style="text-align: left;">电费</td> </tr> <tr> <td style="text-align: left;">4</td> <td style="text-align: left;">油卡</td> </tr> <tr> <td style="text-align: left;">5</td> <td style="text-align: left;">权益</td> </tr> <tr> <td style="text-align: left;">6</td> <td style="text-align: left;">卡券</td> </tr> <tr> <td style="text-align: left;">7</td> <td style="text-align: left;">微信支付宝</td> </tr> </tbody> </table> <ul> <li>产品运营商(productOperator),枚举</li> </ul> <table> <thead> <tr> <th style="text-align: left;">运营商类型</th> <th style="text-align: left;">名称</th> <th style="text-align: left;">属于业务</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">0</td> <td style="text-align: left;">全网</td> <td style="text-align: left;">话费、流量</td> </tr> <tr> <td style="text-align: left;">1</td> <td style="text-align: left;">移动</td> <td style="text-align: left;">话费、流量</td> </tr> <tr> <td style="text-align: left;">2</td> <td style="text-align: left;">联通</td> <td style="text-align: left;">话费、流量</td> </tr> <tr> <td style="text-align: left;">3</td> <td style="text-align: left;">电信</td> <td style="text-align: left;">话费、流量</td> </tr> <tr> <td style="text-align: left;">9</td> <td style="text-align: left;">广电</td> <td style="text-align: left;">话费、流量</td> </tr> <tr> <td style="text-align: left;">4</td> <td style="text-align: left;">中石油</td> <td style="text-align: left;">油卡</td> </tr> <tr> <td style="text-align: left;">5</td> <td style="text-align: left;">中石化</td> <td style="text-align: left;">油卡</td> </tr> <tr> <td style="text-align: left;">6</td> <td style="text-align: left;">广东石化</td> <td style="text-align: left;">油卡</td> </tr> <tr> <td style="text-align: left;">7</td> <td style="text-align: left;">南网</td> <td style="text-align: left;">电费</td> </tr> <tr> <td style="text-align: left;">8</td> <td style="text-align: left;">国网</td> <td style="text-align: left;">电费</td> </tr> <tr> <td style="text-align: left;">36</td> <td style="text-align: left;">权益通用运营商</td> <td style="text-align: left;">权益</td> </tr> <tr> <td style="text-align: left;">37</td> <td style="text-align: left;">京东礼品卡(直充)</td> <td style="text-align: left;">权益</td> </tr> <tr> <td style="text-align: left;">38</td> <td style="text-align: left;">虚拟币</td> <td style="text-align: left;">权益</td> </tr> <tr> <td style="text-align: left;">39</td> <td style="text-align: left;">前向流量</td> <td style="text-align: left;">权益</td> </tr> <tr> <td style="text-align: left;">40</td> <td style="text-align: left;">权益任意数量</td> <td style="text-align: left;">权益</td> </tr> <tr> <td style="text-align: left;">41</td> <td style="text-align: left;">卡券通用运营商</td> <td style="text-align: left;">卡券</td> </tr> <tr> <td style="text-align: left;">42</td> <td style="text-align: left;">支付宝固定立减金</td> <td style="text-align: left;">微信支付宝</td> </tr> <tr> <td style="text-align: left;">43</td> <td style="text-align: left;">支付宝直充</td> <td style="text-align: left;">微信支付宝</td> </tr> <tr> <td style="text-align: left;">44</td> <td style="text-align: left;">微信红包</td> <td style="text-align: left;">微信支付宝</td> </tr> <tr> <td style="text-align: left;">45</td> <td style="text-align: left;">微信固定立减金</td> <td style="text-align: left;">微信支付宝</td> </tr> <tr> <td style="text-align: left;">46</td> <td style="text-align: left;">微信不定额立减金</td> <td style="text-align: left;">微信支付宝</td> </tr> </tbody> </table>

页面列表

ITEM_HTML