simApi

物联网平台API


网卡可订购套餐查询

<h5>简要描述</h5> <ul> <li>查询指定的网卡可订购使用的套餐</li> </ul> <h5>请求URL</h5> <ul> <li><code>http://域名/Api/IotApi/querySimPkgInfo</code></li> </ul> <h5>请求方式</h5> <ul> <li>POST</li> </ul> <h5>数据格式</h5> <ul> <li>表单(application/x-www-form-urlencoded)</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;">appId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>appId</td> </tr> <tr> <td style="text-align: left;">simId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>卡号</td> </tr> <tr> <td style="text-align: left;">sd</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>是否返回套餐有效期, 1:返回</td> </tr> <tr> <td style="text-align: left;">isDes</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>是否返回套餐描述信息, 1:返回</td> </tr> <tr> <td style="text-align: left;">timeStamp</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>当前时间秒级时间戳</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>签名,参考通信规范章节中的 [《签名算法》][1]生成</td> </tr> </tbody> </table> <h5>返回示例 (Json)</h5> <pre><code>{ &amp;quot;code&amp;quot;: 0, &amp;quot;istest&amp;quot;: 0, &amp;quot;data&amp;quot;: [ { &amp;quot;pkgId&amp;quot;: 10001, &amp;quot;pkgName&amp;quot;: &amp;quot;联通小香蕉10G&amp;quot;, &amp;quot;price&amp;quot;: 8, &amp;quot;sprice&amp;quot;: 15, &amp;quot;traffic&amp;quot;: 10240, &amp;quot;isphe&amp;quot;: 0, &amp;quot;voice&amp;quot;: 0, &amp;quot;sms&amp;quot;: 0, &amp;quot;type&amp;quot;: 2, &amp;quot;isdm&amp;quot;: 1, &amp;quot;isnm&amp;quot;: 0, &amp;quot;istest&amp;quot;: 0, &amp;quot;ismul&amp;quot;: 0, &amp;quot;isuni&amp;quot;: 0, &amp;quot;isimm&amp;quot;: 1, &amp;quot;stime&amp;quot;: &amp;quot;2020/05/03&amp;quot;, &amp;quot;etime&amp;quot;: &amp;quot;2020/05/31&amp;quot;, &amp;quot;daynum&amp;quot;: 0, &amp;quot;isred&amp;quot;: 1, &amp;quot;ranknum&amp;quot;: 100, &amp;quot;hideTf&amp;quot;: 0 }, { &amp;quot;pkgId&amp;quot;: 10010, &amp;quot;pkgName&amp;quot;: &amp;quot;联通加速包20G&amp;quot;, &amp;quot;price&amp;quot;: 24, &amp;quot;sprice&amp;quot;: 30, &amp;quot;traffic&amp;quot;: 20480, &amp;quot;isphe&amp;quot;: 0, &amp;quot;voice&amp;quot;: 0, &amp;quot;sms&amp;quot;: 0, &amp;quot;type&amp;quot;: 2, &amp;quot;isdm&amp;quot;: 0, &amp;quot;isnm&amp;quot;: 1, &amp;quot;istest&amp;quot;: 0, &amp;quot;ismul&amp;quot;: 0, &amp;quot;isuni&amp;quot;: 0, &amp;quot;isimm&amp;quot;: 0, &amp;quot;stime&amp;quot;: &amp;quot;2020/05/03&amp;quot;, &amp;quot;etime&amp;quot;: &amp;quot;2020/05/31&amp;quot;, &amp;quot;stime2&amp;quot;: &amp;quot;2020/06/01&amp;quot;, &amp;quot;etime2&amp;quot;: &amp;quot;2020/06/30&amp;quot;, &amp;quot;daynum&amp;quot;: 0, &amp;quot;isred&amp;quot;: 0, &amp;quot;ranknum&amp;quot;: 0, &amp;quot;hideTf&amp;quot;: 0 }, ... ], &amp;quot;msg&amp;quot;: &amp;quot;OK&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;">int</td> <td>返回错误代码,0:成功</td> </tr> <tr> <td style="text-align: left;">istest</td> <td style="text-align: left;">int</td> <td>当前使用流量包是否为体验包(体验包将于订购正式流量包后立即失效); 1:是 0:否</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">object</td> <td>返回数据,详情请查看下方data参数说明</td> </tr> <tr> <td style="text-align: left;">msg</td> <td style="text-align: left;">string</td> <td>当code不为0时,错误提示</td> </tr> </tbody> </table> <h6>data参数说明</h6> <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;">pkgId</td> <td style="text-align: left;">int</td> <td>流量包ID</td> </tr> <tr> <td style="text-align: left;">pkgName</td> <td style="text-align: left;">string</td> <td>流量包名字</td> </tr> <tr> <td style="text-align: left;">price</td> <td style="text-align: left;">float</td> <td>流量包成本价格,单位: 元</td> </tr> <tr> <td style="text-align: left;">sprice</td> <td style="text-align: left;">float</td> <td>流量包零售价格,单位: 元</td> </tr> <tr> <td style="text-align: left;">traffic</td> <td style="text-align: left;">int</td> <td>流量包大小,单位: MB</td> </tr> <tr> <td style="text-align: left;">voice</td> <td style="text-align: left;">int</td> <td>语音时长,单位: 分钟</td> </tr> <tr> <td style="text-align: left;">sms</td> <td style="text-align: left;">int</td> <td>短信数量,单位: 条</td> </tr> <tr> <td style="text-align: left;">isphe</td> <td style="text-align: left;">int</td> <td>是否为语音/短信包; 1:是 0:否</td> </tr> <tr> <td style="text-align: left;">type</td> <td style="text-align: left;">int</td> <td>流量包类型,1:叠加包 2:单月套餐 3:季度套餐 4:半年套餐 5:全年套餐 6:每月套餐(3个月) 7:每月套餐(6个月) 8:每月套餐(12个月) 0:N天套餐;详情请查看<a href="https://www.showdoc.com.cn/916774523755909?page_id=5247494114433419&amp;quot;套餐定义&amp;quot;">套餐定义</a></td> </tr> <tr> <td style="text-align: left;">isdm</td> <td style="text-align: left;">int</td> <td>是否依赖主套餐,此字段只有套餐类型为叠加包时有效; 1:依赖主套餐 0:独立</td> </tr> <tr> <td style="text-align: left;">isnm</td> <td style="text-align: left;">int</td> <td>是否支持次月生效,此字段只有套餐类型为独立叠加包时有效; 1:支持 0:不支持</td> </tr> <tr> <td style="text-align: left;">istest</td> <td style="text-align: left;">int</td> <td>是否为体验包; 1:是 0:否</td> </tr> <tr> <td style="text-align: left;">ismul</td> <td style="text-align: left;">int</td> <td>当istest=1时有效,是否允许与其它体验包同时订购; 1:是 0:否</td> </tr> <tr> <td style="text-align: left;">isimm</td> <td style="text-align: left;">int</td> <td>订购后是否立即叠加生效; 1:是 0:否</td> </tr> <tr> <td style="text-align: left;">isuni</td> <td style="text-align: left;">int</td> <td>是否仅限一次购买; 1:是 0:否</td> </tr> <tr> <td style="text-align: left;">stime,etime</td> <td style="text-align: left;">string</td> <td>当传递参数 sd=1 时,返回此字段,分别代表套餐的生效起始日期和结束日期</td> </tr> <tr> <td style="text-align: left;">stime2,etime2</td> <td style="text-align: left;">string</td> <td>当传递参数 sd=1 ,并且套餐支持次月生效时,返回此字段,分别代表次月生效的生效起始日期和结束日期</td> </tr> <tr> <td style="text-align: left;">daynum</td> <td style="text-align: left;">int</td> <td>当type=0时,表示套餐有效天数;当type=5或type=8 且 daynum&gt;0 时,表示套餐的有效年数</td> </tr> <tr> <td style="text-align: left;">isred</td> <td style="text-align: left;">int</td> <td>用于辅助展示,是否为推荐购买套餐; 1:是 0:否</td> </tr> <tr> <td style="text-align: left;">ranknum</td> <td style="text-align: left;">int</td> <td>用于辅助展示,当前套餐排位号码,数字越大展示排位越前;</td> </tr> <tr> <td style="text-align: left;">svipday</td> <td style="text-align: left;">int</td> <td>订购套餐赠送极速会员天数;</td> </tr> <tr> <td style="text-align: left;">hideTf</td> <td style="text-align: left;">int</td> <td>是否需要隐藏总流量;1:是 0:否</td> </tr> <tr> <td style="text-align: left;">des</td> <td style="text-align: left;">string</td> <td>当传递参数 isDes=1 时,返回此字段,流量包描述信息</td> </tr> </tbody> </table> <h5>备注</h5> <ul> <li>更多返回错误代码请看首页的错误代码描述 [1]: <a href="https://www.showdoc.cc/916774523755909?page_id=4853199661052891">https://www.showdoc.cc/916774523755909?page_id=4853199661052891</a> &quot;《签名算法》&quot;</li> </ul>

页面列表

ITEM_HTML