“Y”-物联_API文档

API文档示例


批量查询总流量和剩余量

<p><strong>简要描述:</strong> </p> <ul> <li>总流量和剩余量查询</li> </ul> <p><strong>请求URL:</strong> </p> <ul> <li><code>http://www.szyriot.com/openApi/sim/queryGprsPkg </code></li> </ul> <p><strong>请求方式:</strong></p> <ul> <li>GET</li> </ul> <p><strong>认证:</strong></p> <ul> <li>在headers中增加Bearer Token的认证,填入(Token) 认证方式为HTTP Bearer Token,认证信息为Bearer:详见获取token接口中返回的token信息 <strong>参数:</strong> </li> </ul> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <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;">msisdn</td> <td style="text-align: left;">否(必选一个)</td> <td style="text-align: left;">string</td> <td style="text-align: left;">msisdn卡号,多个以“_”分割</td> </tr> <tr> <td style="text-align: left;">iccid</td> <td style="text-align: left;">否(必选一个)</td> <td style="text-align: left;">string</td> <td style="text-align: left;">iccid卡号,多个以“_”分割</td> </tr> </tbody> </table> <p><strong>请求示例</strong></p> <pre><code> http://www.szyriot.com/openApi/sim/queryGprsPkg?iccid=123_124 </code></pre> <p><strong>返回示例</strong></p> <pre><code>{ "code": 200, "data": [ { "iccid": "898604341919F0011593", "gross": 102400, "surplus": 100, "gprs": "102300", "msisdn": "1440349311293", "pkg": 3 }, { "iccid": "898604341919F0011594", "gross": 102400, "surplus": 102400, "gprs": "0", "msisdn": "1440349311294", "pkg": 3 }, { "msg": "查詢成功", "code": "0000" } ], "message": "success" }</code></pre> <p><strong>返回参数说明</strong> </p> <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;">msisdn</td> <td style="text-align: left;">String</td> <td>msisdn</td> </tr> <tr> <td style="text-align: left;">iccid</td> <td style="text-align: left;">String</td> <td>iccid</td> </tr> <tr> <td style="text-align: left;">gross</td> <td style="text-align: left;">String</td> <td>单卡套餐总流量 (KB)</td> </tr> <tr> <td style="text-align: left;">gprs</td> <td style="text-align: left;">String</td> <td>使用量(KB)</td> </tr> <tr> <td style="text-align: left;">surplus</td> <td style="text-align: left;">String</td> <td>剩余量 (KB)</td> </tr> <tr> <td style="text-align: left;">pkg</td> <td style="text-align: left;">String</td> <td>套餐类型</td> </tr> </tbody> </table> <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;">5M/月</td> </tr> <tr> <td style="text-align: left;">2</td> <td style="text-align: left;">30M/月</td> </tr> <tr> <td style="text-align: left;">3</td> <td style="text-align: left;">100M/月</td> </tr> <tr> <td style="text-align: left;">4</td> <td style="text-align: left;">300M/月</td> </tr> <tr> <td style="text-align: left;">5</td> <td style="text-align: left;">500M/月</td> </tr> <tr> <td style="text-align: left;">6</td> <td style="text-align: left;">1G/月</td> </tr> <tr> <td style="text-align: left;">7</td> <td style="text-align: left;">3G/月</td> </tr> <tr> <td style="text-align: left;">8</td> <td style="text-align: left;">6G/月</td> </tr> <tr> <td style="text-align: left;">9</td> <td style="text-align: left;">12G/月</td> </tr> <tr> <td style="text-align: left;">10</td> <td style="text-align: left;">NB50M/年</td> </tr> <tr> <td style="text-align: left;">11</td> <td style="text-align: left;">NB300M/年</td> </tr> <tr> <td style="text-align: left;">12</td> <td style="text-align: left;">20G/月</td> </tr> <tr> <td style="text-align: left;">13</td> <td style="text-align: left;">10G/月</td> </tr> <tr> <td style="text-align: left;">14</td> <td style="text-align: left;">10M/月</td> </tr> <tr> <td style="text-align: left;">15</td> <td style="text-align: left;">70M/月</td> </tr> <tr> <td style="text-align: left;">16</td> <td style="text-align: left;">2G/月</td> </tr> <tr> <td style="text-align: left;">17</td> <td style="text-align: left;">100M/年套餐</td> </tr> <tr> <td style="text-align: left;">18</td> <td style="text-align: left;">300M/年套餐</td> </tr> <tr> <td style="text-align: left;">19</td> <td style="text-align: left;">500M/年套餐</td> </tr> <tr> <td style="text-align: left;">20</td> <td style="text-align: left;">1G/年套餐</td> </tr> <tr> <td style="text-align: left;">21</td> <td style="text-align: left;">2G/年套餐</td> </tr> <tr> <td style="text-align: left;">22</td> <td style="text-align: left;">3G/年套餐</td> </tr> <tr> <td style="text-align: left;">23</td> <td style="text-align: left;">48G/年套餐</td> </tr> <tr> <td style="text-align: left;">24</td> <td style="text-align: left;">2M套餐</td> </tr> <tr> <td style="text-align: left;">25</td> <td style="text-align: left;">36G/年套餐</td> </tr> <tr> <td style="text-align: left;">27</td> <td style="text-align: left;">12G/年</td> </tr> <tr> <td style="text-align: left;">28</td> <td style="text-align: left;">6G/年</td> </tr> <tr> <td style="text-align: left;">29</td> <td style="text-align: left;">1200M/年</td> </tr> <tr> <td style="text-align: left;">30</td> <td style="text-align: left;">24G/年</td> </tr> <tr> <td style="text-align: left;">31</td> <td style="text-align: left;">120G/年</td> </tr> <tr> <td style="text-align: left;">32</td> <td style="text-align: left;">100G/月</td> </tr> <tr> <td style="text-align: left;">33</td> <td style="text-align: left;">50M/月</td> </tr> <tr> <td style="text-align: left;">34</td> <td style="text-align: left;">100G/年</td> </tr> <tr> <td style="text-align: left;">35</td> <td style="text-align: left;">10G/年</td> </tr> <tr> <td style="text-align: left;">36</td> <td style="text-align: left;">60G/年</td> </tr> <tr> <td style="text-align: left;">37</td> <td style="text-align: left;">1500M/月</td> </tr> <tr> <td style="text-align: left;">38</td> <td style="text-align: left;">4G/月</td> </tr> <tr> <td style="text-align: left;">39</td> <td style="text-align: left;">30G/月</td> </tr> <tr> <td style="text-align: left;">40</td> <td style="text-align: left;">5G/月</td> </tr> <tr> <td style="text-align: left;">41</td> <td style="text-align: left;">8G/年</td> </tr> <tr> <td style="text-align: left;">42</td> <td style="text-align: left;">50G/月</td> </tr> <tr> <td style="text-align: left;">43</td> <td style="text-align: left;">8G/月</td> </tr> <tr> <td style="text-align: left;">44</td> <td style="text-align: left;">50M/年</td> </tr> <tr> <td style="text-align: left;">45</td> <td style="text-align: left;">80G/月</td> </tr> <tr> <td style="text-align: left;">46</td> <td style="text-align: left;">200G/月</td> </tr> <tr> <td style="text-align: left;">47</td> <td style="text-align: left;">300G/月</td> </tr> <tr> <td style="text-align: left;">48</td> <td style="text-align: left;">400G/月</td> </tr> <tr> <td style="text-align: left;">49</td> <td style="text-align: left;">500G/月</td> </tr> <tr> <td style="text-align: left;">50</td> <td style="text-align: left;">36G/年套餐</td> </tr> <tr> <td style="text-align: left;">51</td> <td style="text-align: left;">700G/月</td> </tr> <tr> <td style="text-align: left;">52</td> <td style="text-align: left;">800G/月</td> </tr> <tr> <td style="text-align: left;">53</td> <td style="text-align: left;">900G/月</td> </tr> <tr> <td style="text-align: left;">54</td> <td style="text-align: left;">1000G/月</td> </tr> <tr> <td style="text-align: left;">58</td> <td style="text-align: left;">50G/季</td> </tr> <tr> <td style="text-align: left;">59</td> <td style="text-align: left;">80G/季</td> </tr> <tr> <td style="text-align: left;">60</td> <td style="text-align: left;">100G/季</td> </tr> <tr> <td style="text-align: left;">61</td> <td style="text-align: left;">200G/年</td> </tr> <tr> <td style="text-align: left;">62</td> <td style="text-align: left;">500G/年</td> </tr> <tr> <td style="text-align: left;">63</td> <td style="text-align: left;">1000G/年</td> </tr> <tr> <td style="text-align: left;">64</td> <td style="text-align: left;">72G/年</td> </tr> <tr> <td style="text-align: left;">65</td> <td style="text-align: left;">11G/月</td> </tr> <tr> <td style="text-align: left;">66</td> <td style="text-align: left;">20G/年</td> </tr> <tr> <td style="text-align: left;">67</td> <td style="text-align: left;">3600M/年</td> </tr> </tbody> </table> <p><strong>备注</strong> </p> <ul> <li>更多返回错误代码请看首页的错误代码描述</li> </ul>

页面列表

ITEM_HTML