“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/changeCardStatus </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;">type</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td style="text-align: left;">操作类型(1 停机 2 开机)</td> </tr> </tbody> </table> <p><strong>请求示例</strong></p> <pre><code> http://www.szyriot.com/openApi/sim/changeCardStatus?msisdn=123456_123567&amp;type=1 </code></pre> <p><strong>返回示例</strong></p> <pre><code>操作成功: { "code": 200, "data": [ { "msg": "操作成功30分钟内中断通讯", "code": "0000", "msisdn": "123456" } ], "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;">code</td> <td style="text-align: left;">String</td> <td>返回状态码</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;">msisdn</td> <td style="text-align: left;">String</td> <td>msisdn</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;">6002</td> <td style="text-align: left;">操作成功</td> </tr> <tr> <td style="text-align: left;">1000</td> <td style="text-align: left;">请求参数错误</td> </tr> <tr> <td style="text-align: left;">6002</td> <td style="text-align: left;">卡号不在该用户上</td> </tr> <tr> <td style="text-align: left;">6003</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> <p><strong>备注</strong> </p> <ul> <li>一次批量请求,最大为30张(过多会导致失败)。接口频次限定为30s,请勿频繁发生请求,导致停复机失败</li> </ul>

页面列表

ITEM_HTML