通话电子学生证数据同步接口规范

通话电子学生证


学生数据同步接口

<h5>简要描述</h5> <ul> <li>学生数据同步接口</li> </ul> <h5>请求URL</h5> <ul> <li><code>https://scard.edusino.cn/api/jykxsf/student/sync</code></li> </ul> <h5>请求方式</h5> <ul> <li>POST </li> </ul> <h5>参数</h5> <p>HTTP首部(Header) 教育可信数字身份后台管理系统的鉴权凭证,在HTTP认证的Bearer形式里提供。下例的 Bearer 后面的字符串即鉴权凭证。 Authorization : Bearer cn389ncoiwuencr 注,如果请求未提供鉴权凭证,那么返回的HTTP状态码将是401(而不是200)。</p> <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;">students</td> <td style="text-align: left;">是</td> <td style="text-align: left;">list</td> <td>学生数据列表(参考数据定义章节)以json格式</td> </tr> </tbody> </table> <h5>请求示例</h5> <pre><code> { "students": [ {"esn":"xxxx","xxxx":"xxx"}, {"esn":"xxxx","xxxx":"xxx"}, {"esn":"xxxx","xxxx":"xxx"} ] }</code></pre> <h5>返回示例</h5> <pre><code> { "err": 0, "msg": "xxxxxxxx", "err_esn": [ { "esn":"xxxxxxxx", "err_code": "", "err_msg":"" } ] }</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;">err_esn</td> <td style="text-align: left;">String</td> <td>失败的ESN号,多个时以 逗号 隔开,没有时为空</td> </tr> </tbody> </table> <h5>备注</h5> <ul> <li>更多返回错误代码请看首页的错误代码描述</li> </ul>

页面列表

ITEM_HTML