基于电子学生证的校内刷卡应用《校园基础版》数据交互接口文档V1.0.docVIP

安全级别：企业

PAGE8

PAGE8

基于电子学生证的校内刷卡应用

《校园基础版》

数据交互接口文档

(v1.0)

文档版本记录

日期

版本号

更新说明

作者

2015-09-24

V1.0

目录

TOC\o1-3\h\u311461、编制说明 4

128112、通讯方式RESTfulWebServices 4

86343、认证方式 4

232074、数据包接口 4

247365、加密方式 5

287356、请求说明 5

REF_Ref413142284\n\h7、返回值说明 6

142048、数据字段标准 7

编制说明

用于第三方平台与校园基础班交互学生刷卡数据

第三方平台需要通过我方数据接口，上报校本课程以及主题活动申报明细到闵行区学生电子成长档案。

通讯方式RESTfulWebServices

调用方式：标准HTTP

提交方式：POST

访问地址：

http://xx.xxx.xx.xx:xxxx/info_rest/data/register(用户注册)

http://xx.xxx.xx.xx:xxxx/info_rest/data/report_kc(上报课程)

http://xx.xxx.xx.xx:xxxx/info_rest/data/report_hd(上报主题活动)

http://xx.xxx.xx.xx:xxxx/info_rest/data/getskinfo(获取刷卡数据)

认证方式

username+pwd的方式进行身份验证。

测试账号信息：

username：test

pwd:123

数据包接口

传输的所有参数及数据均为JSONObject。

加密方式

返回数据均采用Base64加密算法对JSONObject的部分值进行加密。

请求说明

编号

1

功能描述

(用户注册)

url

http://xx.xxx.xx.xx:xxxx/info_rest/data/register

请求

结构

说明

username

RESTfulWebServices用户编码(用户申请)

companyname

公司名称

响应

pwd

返回秘钥

error

失败

编号

2

功能描述

(上报校本课程)

url

http://xx.xxx.xx.xx:xxxx/info_rest/data/report_kc

请求

结构

说明

username

RESTfulWebServices用户编码(用户申请)

pwd

RESTfulWebServices用户密码(服务端提供)

datas[数组]

列名

说明

ID

主键

XN

学年

XQ

学期

XJH

学籍号

KCBH

课程编号

KCMC

课程名称

KCLX

课程类型

KCJB

课程级别

SX

属性（探究型，拓展型等）

SYJCMC

所用教材名称

SYJCXZ

所用教材性质

ZSRS

招生人数

KSL_YJ

课时量-学校预计课时量

KSL_SJ

课时量-学校实际开展课时量

SKDD

上课地点

SKXS

上课形式

RKJS

任课教师

SKSJ

上课时间

响应

ok

接收成功

error

失败

编号

3

功能描述

(上报主题活动)

url

http://xx.xxx.xx.xx:xxxx/info_rest/data/report_hd

请求

结构

说明

username

RESTfulWebServices用户编码(服务端提供)

pwd

RESTfulWebServices用户密码(服务端提供)

datas[数组]

列名

说明

ID

主键

XN

学年

XQ

学期

XJH

学籍号

TYLX

体验类型

HDMC

活动名称

HDNR

活动内容

HDDD

活动地点

ZSJB

展示级别

ZSXS

展示形式

ZSJG

展示结果

ZDJS1

指导教师1

ZDJS2

指导教师2

SFHJ

是否获奖

HJLX

获奖类型

HDKSSJ

活动开始时间

HDJSSJ

活动结束时间

响应

ok

接收成功

error

失败

编号

4

功能描述

(获取刷卡数据)

url

http://xx.xxx.xx.xx:xxxx/info_rest/data/getskinfo

请求

结构

说明

username

RESTfulWebServices用户编码(服务端提供)

pwd

RESTfulWebServices用户密码(服务端提供)

dat