simApi

物联网平台API


查询网卡已订购套餐

<h5>简要描述</h5> <ul> <li>查询指定的网卡已订购并且未失效的套餐</li> </ul> <h5>请求URL</h5> <ul> <li><code>http://域名/Api/IotApi/queryOrderedPkgInfo</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;">expired</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>是否查询过期套餐(一年内); 1:是,0:否。 默认为0不查询</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;data&amp;quot;: [ { &amp;quot;name&amp;quot;: &amp;quot;月卡15G&amp;quot;, &amp;quot;pkgId&amp;quot;: 10001, &amp;quot;traffic&amp;quot;: 15360, &amp;quot;ntraffic&amp;quot;: 10360.56, &amp;quot;starttime&amp;quot;: 1596470400, &amp;quot;endtime&amp;quot;: 1599235199, &amp;quot;addtime&amp;quot;: 1596481150 }, { &amp;quot;name&amp;quot;: &amp;quot;月卡10G&amp;quot;, &amp;quot;pkgId&amp;quot;: 10001, &amp;quot;traffic&amp;quot;: 10240, &amp;quot;ntraffic&amp;quot;: 235.72, &amp;quot;starttime&amp;quot;: 1599235200, &amp;quot;endtime&amp;quot;: 1601913599, &amp;quot;addtime&amp;quot;: 1596483628 }, ... ], &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;">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;">name</td> <td style="text-align: left;">string</td> <td>套餐名字</td> </tr> <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;">traffic</td> <td style="text-align: left;">int</td> <td>流量大小,单位:MB</td> </tr> <tr> <td style="text-align: left;">ntraffic</td> <td style="text-align: left;">float</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;">nvoice</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;">nsms</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天套餐;详情请查看[套餐定义][3]</td> </tr> <tr> <td style="text-align: left;">starttime</td> <td style="text-align: left;">int</td> <td>流量生效起始时间时间戳</td> </tr> <tr> <td style="text-align: left;">endtime</td> <td style="text-align: left;">int</td> <td>流量生效结束时间时间戳</td> </tr> <tr> <td style="text-align: left;">addtime</td> <td style="text-align: left;">int</td> <td>订购时间时间戳</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