金磐石权益服务平台


获取商品列表接口

<h4>接口方法:</h4> <ul> <li>goods.list</li> </ul> <h4>接口名称:</h4> <ul> <li>获取商品列表接口</li> </ul> <h4>请求方式:</h4> <ul> <li>POST</li> </ul> <h4>数据格式:</h4> <ul> <li>application/json</li> </ul> <h1>请求地址</h1> <table> <thead> <tr> <th>环境</th> <th>HTTPS地址</th> </tr> </thead> <tbody> <tr> <td>正式环境</td> <td></td> </tr> <tr> <td>沙箱环境</td> <td><a href="https://test.jpsdt.com/openapi/api/getway">https://test.jpsdt.com/openapi/api/getway</a></td> </tr> </tbody> </table> <h1>公共请求参数</h1> <table> <thead> <tr> <th>参数名称</th> <th>字段类型</th> <th>是否必填</th> <th>最大长度</th> <th>示例值</th> <th>描述</th> </tr> </thead> <tbody> <tr> <td>customerId</td> <td>string</td> <td>是</td> <td>9</td> <td>1648051962</td> <td>客户ID(平台分配)</td> </tr> <tr> <td>method</td> <td>string</td> <td>是</td> <td>128</td> <td>goods.list</td> <td>接口方法名称</td> </tr> <tr> <td>timestamp</td> <td>string</td> <td>是</td> <td>192</td> <td>2023-12-19 10:23:06</td> <td>时间戳,格式为:yyyy-MM-dd HH:mm:ss</td> </tr> <tr> <td>version</td> <td>string</td> <td>是</td> <td>3</td> <td>1.0</td> <td>调用的接口版本</td> </tr> <tr> <td>sign</td> <td>string</td> <td>是</td> <td>344</td> <td>详见示例</td> <td>签名串,签名规则详见左侧菜单:接口规范-&gt;签名规则</td> </tr> <tr> <td>bizContent</td> <td>string</td> <td>是</td> <td></td> <td>&quot;{\&quot;goodsType\&quot;:\&quot;20\&quot;,categoryCode\&quot;:\&quot;SPYY\&quot;,keywords\&quot;:\&quot;会员周卡\&quot;,pageNum\&quot;:\&quot;1\&quot;,pageSize\&quot;:\&quot;10\&quot;}&quot;</td> <td>请求参数集合&lt;br&gt;注意:该参数是以json字符串的形式传输</td> </tr> </tbody> </table> <h1>请求参数</h1> <table> <thead> <tr> <th>参数名称</th> <th>字段类型</th> <th>是否必填</th> <th>最大长度</th> <th>示例值</th> <th>描述</th> </tr> </thead> <tbody> <tr> <td>goodsType</td> <td>String</td> <td>是</td> <td>9</td> <td>20</td> <td>商品类型:10-卡密、20-直充、30-话费</td> </tr> <tr> <td>categoryCode</td> <td>String</td> <td>是</td> <td>10</td> <td>SPYY</td> <td>商品类别:SPYY-视频影音、SHCX-生活出行</td> </tr> <tr> <td>keywords</td> <td>String</td> <td>是</td> <td>255</td> <td>会员周卡</td> <td>关键字:商品ID或商品名称</td> </tr> <tr> <td>pageNum</td> <td>String</td> <td>是</td> <td>255</td> <td>1</td> <td>页码</td> </tr> <tr> <td>pageSize</td> <td>String</td> <td>是</td> <td>255</td> <td>1</td> <td>页面查询条数</td> </tr> </tbody> </table> <h1>公共响应参数</h1> <table> <thead> <tr> <th>参数名称</th> <th>字段类型</th> <th>是否必填</th> <th>最大长度</th> <th>示例值</th> <th>描述</th> </tr> </thead> <tbody> <tr> <td>code</td> <td>String</td> <td>是</td> <td>6</td> <td>0</td> <td>返回码,详见《业务场景码》</td> </tr> <tr> <td>message</td> <td>String</td> <td>是</td> <td></td> <td>接口调用成功</td> <td>返回码描述,详见《业务场景码》</td> </tr> <tr> <td>data</td> <td>Object</td> <td>是</td> <td></td> <td></td> <td>响应结果集</td> </tr> </tbody> </table> <h1>响应参数</h1> <table> <thead> <tr> <th>参数名称</th> <th>字段类型</th> <th>是否必填</th> <th>最大长度</th> <th>示例值</th> <th>描述</th> </tr> </thead> <tbody> <tr> <td>goodsId</td> <td>String</td> <td>是</td> <td></td> <td>20000102</td> <td>商品ID</td> </tr> <tr> <td>goodsName</td> <td>String</td> <td>是</td> <td></td> <td>腾讯视频会员周卡</td> <td>商品名称</td> </tr> <tr> <td>goodsType</td> <td>String</td> <td>是</td> <td></td> <td>直充</td> <td>商品类型</td> </tr> <tr> <td>category</td> <td>String</td> <td>是</td> <td></td> <td>视频影音</td> <td>商品类别</td> </tr> <tr> <td>parvalue</td> <td>String</td> <td>是</td> <td></td> <td>14.0000</td> <td>面值</td> </tr> <tr> <td>sellPrice</td> <td>String</td> <td>是</td> <td></td> <td>6.8600</td> <td>供货价</td> </tr> <tr> <td>status</td> <td>String</td> <td>是</td> <td></td> <td>上架</td> <td>状态</td> </tr> </tbody> </table> <h1>请求示例</h1> <pre><code>{ &amp;quot;saasId&amp;quot;:&amp;quot;12345678901234567890&amp;quot;, &amp;quot;method&amp;quot;:&amp;quot;jpsdt.chatroom.member.list&amp;quot;, &amp;quot;timestamp&amp;quot;:&amp;quot;2023-12-19 10:23:06&amp;quot;, &amp;quot;version&amp;quot;:&amp;quot;1.0&amp;quot;, &amp;quot;format&amp;quot;:&amp;quot;json&amp;quot;, &amp;quot;charset&amp;quot;:&amp;quot;utf-8&amp;quot;, &amp;quot;signType&amp;quot;:&amp;quot;md5&amp;quot;, &amp;quot;sign&amp;quot;:&amp;quot;d2ca1003c1852e1846c9466adec18b68&amp;quot;, &amp;quot;bizContent&amp;quot;:&amp;quot;{\&amp;quot;goodsType\&amp;quot;:\&amp;quot;20\&amp;quot;,categoryCode\&amp;quot;:\&amp;quot;SPYY\&amp;quot;,keywords\&amp;quot;:\&amp;quot;会员周卡\&amp;quot;,pageNum\&amp;quot;:\&amp;quot;1\&amp;quot;,pageSize\&amp;quot;:\&amp;quot;10\&amp;quot;}&amp;quot; }</code></pre> <h1>响应示例</h1> <pre><code>{ &amp;quot;code&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;message&amp;quot;: &amp;quot;请求成功!&amp;quot;, &amp;quot;data&amp;quot;: { &amp;quot;records&amp;quot;: [ { &amp;quot;goodsId&amp;quot;: &amp;quot;20000102&amp;quot;, &amp;quot;goodsName&amp;quot;: &amp;quot;腾讯视频会员周卡&amp;quot;, &amp;quot;goodsType&amp;quot;: &amp;quot;直充&amp;quot;, &amp;quot;category&amp;quot;: &amp;quot;视频影音&amp;quot;, &amp;quot;parvalue&amp;quot;: &amp;quot;12.0000&amp;quot;, &amp;quot;sellPrice&amp;quot;: &amp;quot;6.8400&amp;quot;, &amp;quot;status&amp;quot;: &amp;quot;上架&amp;quot; }, { &amp;quot;goodsId&amp;quot;: &amp;quot;20000118&amp;quot;, &amp;quot;goodsName&amp;quot;: &amp;quot;优酷会员周卡&amp;quot;, &amp;quot;goodsType&amp;quot;: &amp;quot;直充&amp;quot;, &amp;quot;category&amp;quot;: &amp;quot;视频影音&amp;quot;, &amp;quot;parvalue&amp;quot;: &amp;quot;14.0000&amp;quot;, &amp;quot;sellPrice&amp;quot;: &amp;quot;6.8600&amp;quot;, &amp;quot;status&amp;quot;: &amp;quot;上架&amp;quot; }, { &amp;quot;goodsId&amp;quot;: &amp;quot;20000137&amp;quot;, &amp;quot;goodsName&amp;quot;: &amp;quot;搜狐视频会员周卡&amp;quot;, &amp;quot;goodsType&amp;quot;: &amp;quot;直充&amp;quot;, &amp;quot;category&amp;quot;: &amp;quot;视频影音&amp;quot;, &amp;quot;parvalue&amp;quot;: &amp;quot;6.0000&amp;quot;, &amp;quot;sellPrice&amp;quot;: &amp;quot;3.0000&amp;quot;, &amp;quot;status&amp;quot;: &amp;quot;上架&amp;quot; } ], &amp;quot;total&amp;quot;: &amp;quot;3&amp;quot;, &amp;quot;size&amp;quot;: &amp;quot;10&amp;quot;, &amp;quot;current&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;orders&amp;quot;: [], &amp;quot;optimizeCountSql&amp;quot;: true, &amp;quot;searchCount&amp;quot;: true, &amp;quot;countId&amp;quot;: null, &amp;quot;maxLimit&amp;quot;: null, &amp;quot;pages&amp;quot;: &amp;quot;1&amp;quot; } }</code></pre> <h1>异常示例</h1> <pre><code>{ &amp;quot;code&amp;quot;: -1, &amp;quot;message&amp;quot;: &amp;quot;请求异常&amp;quot;, &amp;quot;data&amp;quot;: &amp;quot;&amp;quot;, }</code></pre>

页面列表

ITEM_HTML