1. 概览

一卡通账户、卡片、充值、补贴、余额相关操作

1.1. 版本信息

版本 : 1.0.0

1.2. URI scheme

域名 : localhost:8089
基础路径 : /

1.3. 标签

  • 交易明细接口 : Money Change Controller

  • 卡片打印模板接口 : Card Print Template Controller

  • 卡片接口(手机端|自助终端) : M Tcommcard Controller

  • 卡片接口(管理员) : Tcommcard Controller

  • 卡类型接口 : Tcommrole Controller

  • 深澜网费缴纳接口 : Net Recharge Controller

  • 账户交易记录接口 : Ttnsmflwing Controller

  • 账户交易记录接口(手机端) : M Ttnsmflwing Controller

  • 账户余额接口(手机端) : M Tcommbalance Controller

  • 账户充值接口 : Account Recharge Order Controller

  • 账户充值接口(用银行卡充值) : Bank Recharge Controller

  • 账户接口(第三方) : A Tcommaccount Controller

  • 账户接口(管理员) : Tcommaccount Controller

  • 账户补贴接口 : Subsidy Controller

2. 资源

2.1. 交易明细接口

Money Change Controller

2.1.1. 查询交易明细

GET /moneyChangeController/findByPage
参数
类型 名称 说明 类型 默认值

Query

accId
可选

string

Query

accName
可选

string

Query

accStucode
可选

string

Query

accStucode
可选

accStucode

string

Query

afterMoney
可选

number (double)

Query

amout
可选

number (double)

Query

beforeMoney
可选

number (double)

Query

ceateTime
可选

string (date-time)

Query

etime
可选

string

Query

id
可选

string

Query

inMoney
可选

number (double)

Query

limit
可选

limit

integer (int32)

15

Query

opr
可选

string

Query

orderId
可选

string

Query

outMoney
可选

number (double)

Query

page
可选

page

integer (int32)

0

Query

reason
可选

string

Query

sort
可选

sort

string

Query

stime
可选

string

Query

terId
可选

string

Query

toAccId
可选

string

Query

toAccName
可选

string

Query

toAccStucode
可选

string

Body

stuCode
可选

学工号

string

响应
HTTP代码 说明 类型

200

OK

object

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/moneyChangeController/findByPage
请求 query
{
  "accId" : "string",
  "accName" : "string",
  "accStucode" : "string",
  "afterMoney" : 0.0,
  "amout" : 0.0,
  "beforeMoney" : 0.0,
  "ceateTime" : "string",
  "etime" : "string",
  "id" : "string",
  "inMoney" : 0.0,
  "limit" : 0,
  "opr" : "string",
  "orderId" : "string",
  "outMoney" : 0.0,
  "page" : 0,
  "reason" : "string",
  "sort" : "string",
  "stime" : "string",
  "terId" : "string",
  "toAccId" : "string",
  "toAccName" : "string",
  "toAccStucode" : "string"
}
请求 body
{ }
HTTP响应示例
响应 200
"object"

2.2. 卡片打印模板接口

Card Print Template Controller

2.2.1. 删除卡片打印模板

GET /cardPrintTemplateController/delete
参数
类型 名称 说明 类型

Query

id
必填

id

string

Body

cardPrintTemplate
必填

卡片打印模板

CardPrintTemplate

响应
HTTP代码 说明 类型

200

OK

JsonResult

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/cardPrintTemplateController/delete
请求 query
{
  "id" : "string"
}
请求 body
{
  "deleted" : "string",
  "id" : "string",
  "rleId" : "string",
  "templateName" : "string",
  "templateSrc" : "string"
}
HTTP响应示例
响应 200
{
  "code" : "string",
  "data" : "object",
  "message" : "string"
}

2.2.2. 查询卡片打印模板

POST /cardPrintTemplateController/findByPage
说明

分页查询

参数
类型 名称 说明 类型

Query

limit
必填

每页记录条数

ref

Query

page
必填

当前页码

ref

Body

cardPrintTemplate
可选

卡片打印模板

CardPrintTemplate

响应
HTTP代码 说明 类型

200

OK

object

201

Created

无内容

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/cardPrintTemplateController/findByPage
请求 query
{
  "limit" : "ref",
  "page" : "ref"
}
请求 body
{
  "deleted" : "string",
  "id" : "string",
  "rleId" : "string",
  "templateName" : "string",
  "templateSrc" : "string"
}
HTTP响应示例
响应 200
"object"

2.2.3. 根据卡片打印模板ID查询模板

GET /cardPrintTemplateController/get
参数
类型 名称 说明 类型

Query

id
必填

模板ID

string

响应
HTTP代码 说明 类型

200

OK

CardPrintTemplate

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/cardPrintTemplateController/get
请求 query
{
  "id" : "string"
}
HTTP响应示例
响应 200
{
  "deleted" : "string",
  "id" : "string",
  "rleId" : "string",
  "templateName" : "string",
  "templateSrc" : "string"
}

2.2.4. 生成待打印卡片的html字符串

GET /cardPrintTemplateController/getPrintTemplate
说明

可用在浏览器中调试最终打印的卡片样式是否正确

参数
类型 名称 说明 类型

Query

depName
必填

depName

string

Query

limit
必填

每页记录条数

ref

Query

name
必填

name

string

Query

page
必填

当前页码

ref

Query

photo
必填

photo

string

Query

rleId
必填

rleId

string

Query

stuCode
必填

stuCode

string

Query

zhuanye
必填

zhuanye

string

Body

cardPrintTemplate
可选

卡片打印模板

CardPrintTemplate

响应
HTTP代码 说明 类型

200

OK

string

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/cardPrintTemplateController/getPrintTemplate
请求 query
{
  "depName" : "string",
  "limit" : "ref",
  "name" : "string",
  "page" : "ref",
  "photo" : "string",
  "rleId" : "string",
  "stuCode" : "string",
  "zhuanye" : "string"
}
请求 body
{
  "deleted" : "string",
  "id" : "string",
  "rleId" : "string",
  "templateName" : "string",
  "templateSrc" : "string"
}
HTTP响应示例
响应 200
"string"

2.2.5. 新增卡片打印模板

POST /cardPrintTemplateController/save
参数
类型 名称 说明 类型

Body

cardPrintTemplate
必填

卡片打印模板

CardPrintTemplate

响应
HTTP代码 说明 类型

200

OK

JsonResult

201

Created

无内容

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/cardPrintTemplateController/save
请求 body
{
  "deleted" : "string",
  "id" : "string",
  "rleId" : "string",
  "templateName" : "string",
  "templateSrc" : "string"
}
HTTP响应示例
响应 200
{
  "code" : "string",
  "data" : "object",
  "message" : "string"
}

2.2.6. 修改卡片打印模板

POST /cardPrintTemplateController/update
参数
类型 名称 说明 类型

Body

cardPrintTemplate
必填

卡片打印模板

CardPrintTemplate

响应
HTTP代码 说明 类型

200

OK

JsonResult

201

Created

无内容

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/cardPrintTemplateController/update
请求 body
{
  "deleted" : "string",
  "id" : "string",
  "rleId" : "string",
  "templateName" : "string",
  "templateSrc" : "string"
}
HTTP响应示例
响应 200
{
  "code" : "string",
  "data" : "object",
  "message" : "string"
}

2.3. 卡片接口(手机端|自助终端)

M Tcommcard Controller

2.3.1. 根据学号查询卡片

GET /m/tcommcardController/findCardByStuCode
参数
类型 名称 说明 类型

Query

stuCode
必填

学工号

string

响应
HTTP代码 说明 类型

200

OK

JsonResult

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/m/tcommcardController/findCardByStuCode
请求 query
{
  "stuCode" : "string"
}
HTTP响应示例
响应 200
{
  "code" : "string",
  "data" : "object",
  "message" : "string"
}

2.3.2. 根据卡号获取卡片主要信息

GET /m/tcommcardController/getCardMainInfoByCardNo
参数
类型 名称 说明 类型

Query

cardNo
必填

卡号

string

响应
HTTP代码 说明 类型

200

OK

CardMainInfo

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/m/tcommcardController/getCardMainInfoByCardNo
请求 query
{
  "cardNo" : "string"
}
HTTP响应示例
响应 200
{
  "accCname" : "string",
  "accId" : "string",
  "accStatus" : "string",
  "accStucode" : "string",
  "blnBalance" : 0.0,
  "crdNo" : "string",
  "crdStatus" : "string"
}

2.3.3. 获取补卡需要花费的费用

GET /m/tcommcardController/getReplaceCardMoneyByRle
说明

自助终端补卡需要从一卡通账户中扣除补卡费

参数
类型 名称 说明 类型

Query

rle
必填

卡类型

string

响应
HTTP代码 说明 类型

200

OK

string

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/m/tcommcardController/getReplaceCardMoneyByRle
请求 query
{
  "rle" : "string"
}
HTTP响应示例
响应 200
"string"

2.3.4. 获取补卡后的卡信息

GET /m/tcommcardController/getReplacementCardInfo
说明

自助终端补卡,新卡替换掉旧卡

参数
类型 名称 说明 类型

Query

accId
必填

账户ID

ref

Query

cardNo
必填

新卡号

string

响应
HTTP代码 说明 类型

200

OK

JsonResultExt

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/m/tcommcardController/getReplacementCardInfo
请求 query
{
  "accId" : "ref",
  "cardNo" : "string"
}
HTTP响应示例
响应 200
{
  "code" : 0,
  "data" : "object",
  "message" : "string"
}

2.3.5. 挂失卡片

POST /m/tcommcardController/lockCard
说明

手机端

参数
类型 名称 说明 类型

Query

cardNo
必填

卡号

string

Query

idCard
必填

身份证

string

Query

pwd
必填

密码

string

Query

stuCode
必填

学工号

string

响应
HTTP代码 说明 类型

200

OK

JsonResult

201

Created

无内容

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/m/tcommcardController/lockCard
请求 query
{
  "cardNo" : "string",
  "idCard" : "string",
  "pwd" : "string",
  "stuCode" : "string"
}
HTTP响应示例
响应 200
{
  "code" : "string",
  "data" : "object",
  "message" : "string"
}

2.3.6. 挂失卡片

POST /m/tcommcardController/lockCardBySelfHelp
说明

自助终端挂失卡片

参数
类型 名称 说明 类型

Query

cardNo
必填

卡号

string

Query

idCard
必填

身份证

string

Query

pwd
必填

密码

string

Query

stuCode
必填

学工号

string

响应
HTTP代码 说明 类型

200

OK

JsonResult

201

Created

无内容

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/m/tcommcardController/lockCardBySelfHelp
请求 query
{
  "cardNo" : "string",
  "idCard" : "string",
  "pwd" : "string",
  "stuCode" : "string"
}
HTTP响应示例
响应 200
{
  "code" : "string",
  "data" : "object",
  "message" : "string"
}

2.3.7. 解挂卡片

POST /m/tcommcardController/unlockCard
说明

手机端解挂卡片

参数
类型 名称 说明 类型

Query

cardNo
必填

卡号

string

Query

idCard
必填

身份证

string

Query

pwd
必填

密码

string

Query

stuCode
必填

学工号

string

响应
HTTP代码 说明 类型

200

OK

JsonResult

201

Created

无内容

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/m/tcommcardController/unlockCard
请求 query
{
  "cardNo" : "string",
  "idCard" : "string",
  "pwd" : "string",
  "stuCode" : "string"
}
HTTP响应示例
响应 200
{
  "code" : "string",
  "data" : "object",
  "message" : "string"
}

2.3.8. 解挂卡片

POST /m/tcommcardController/unlockCardBySelfHelp
说明

自助终端解挂卡片

参数
类型 名称 说明 类型

Query

cardNo
必填

卡号

string

Query

idCard
必填

身份证

string

Query

pwd
必填

密码

string

Query

stuCode
必填

学工号

string

响应
HTTP代码 说明 类型

200

OK

JsonResult

201

Created

无内容

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/m/tcommcardController/unlockCardBySelfHelp
请求 query
{
  "cardNo" : "string",
  "idCard" : "string",
  "pwd" : "string",
  "stuCode" : "string"
}
HTTP响应示例
响应 200
{
  "code" : "string",
  "data" : "object",
  "message" : "string"
}

2.4. 卡片接口(管理员)

Tcommcard Controller

2.4.1. 查询卡

POST /tcommcardController/findByPageExcept
说明

分页查询用户所有卡信息,不包括注销的卡

参数
类型 名称 说明 类型

Query

limit
必填

每页记录条数

ref

Query

page
必填

当前页码

ref

Body

tcommcard
必填

Tcommcard

响应
HTTP代码 说明 类型

200

OK

object

201

Created

无内容

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/tcommcardController/findByPageExcept
请求 query
{
  "limit" : "ref",
  "page" : "ref"
}
请求 body
{
  "accountBlance" : 0.0,
  "crdAccid" : 0,
  "crdCost" : 0,
  "crdCreatedate" : "string",
  "crdFirstflag" : "string",
  "crdId" : "string",
  "crdLastdate" : "string",
  "crdRoleId" : "string",
  "crdStatus" : "string",
  "crdStatusColor" : "string",
  "crdTypid" : "string",
  "oprorAccId" : "string",
  "stuCode" : "string",
  "tcommaccount" : {
    "accAddress" : "string",
    "accArea" : "string",
    "accAvdate" : "string",
    "accBankcode" : "string",
    "accBirth" : "string",
    "accCadate" : "string",
    "accChgdate" : "string",
    "accCname" : "string",
    "accCnyid" : "string",
    "accCrdate" : "string",
    "accDepid" : "string",
    "accDeposit" : 0.0,
    "accId" : 0,
    "accIdcard" : "string",
    "accIds" : "string",
    "accKind" : "string",
    "accNatid" : "string",
    "accPhoto" : "string",
    "accPwd" : "string",
    "accRemake" : "string",
    "accRleid" : "string",
    "accSex" : "string",
    "accStatus" : "string",
    "accStucode" : "string",
    "attribute1" : "string",
    "balance" : 0.0,
    "blnBalance" : 0.0,
    "bumen" : "string",
    "college" : "string",
    "crdCost" : 0,
    "crdId" : "string",
    "degreen" : "string",
    "duty" : "string",
    "dutyLevel" : "string",
    "guojia" : "string",
    "haveCard" : "string",
    "minzu" : "string",
    "mobile" : "string",
    "oprorAccId" : "string",
    "proId" : "string",
    "profeWid" : "string",
    "professional" : "string",
    "promptInfo" : "string",
    "studyYear" : "string",
    "subject" : "string",
    "type" : "string",
    "xb" : "string",
    "zhuangtai" : "string"
  }
}
HTTP响应示例
响应 200
"object"

2.4.2. 查询卡

GET /tcommcardController/findListByAccId
说明

查询用户所有卡信息

参数
类型 名称 说明 类型

Query

crdAccId
必填

账户ID

ref

响应
HTTP代码 说明 类型

200

OK

object

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/tcommcardController/findListByAccId
请求 query
{
  "crdAccId" : "ref"
}
HTTP响应示例
响应 200
"object"

2.4.3. 查询已挂失且未注销的卡片

GET /tcommcardController/findListToHang
参数
类型 名称 说明 类型

Query

crdAccId
必填

账户ID

ref

响应
HTTP代码 说明 类型

200

OK

object

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/tcommcardController/findListToHang
请求 query
{
  "crdAccId" : "ref"
}
HTTP响应示例
响应 200
"object"

2.4.4. 查询未挂失未注销的卡片

GET /tcommcardController/findListToLoss
说明

查询用户除去已挂失、已注销的卡片外所有卡片信息 用于挂失操作

参数
类型 名称 说明 类型

Query

crdAccId
必填

账户ID

ref

响应
HTTP代码 说明 类型

200

OK

object

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/tcommcardController/findListToLoss
请求 query
{
  "crdAccId" : "ref"
}
HTTP响应示例
响应 200
"object"

2.4.5. 根据卡号查询卡片

GET /tcommcardController/get
参数
类型 名称 说明 类型

Query

crdId
必填

卡号

string

响应
HTTP代码 说明 类型

200

OK

Tcommcard

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/tcommcardController/get
请求 query
{
  "crdId" : "string"
}
HTTP响应示例
响应 200
{
  "accountBlance" : 0.0,
  "crdAccid" : 0,
  "crdCost" : 0,
  "crdCreatedate" : "string",
  "crdFirstflag" : "string",
  "crdId" : "string",
  "crdLastdate" : "string",
  "crdRoleId" : "string",
  "crdStatus" : "string",
  "crdStatusColor" : "string",
  "crdTypid" : "string",
  "oprorAccId" : "string",
  "stuCode" : "string",
  "tcommaccount" : {
    "accAddress" : "string",
    "accArea" : "string",
    "accAvdate" : "string",
    "accBankcode" : "string",
    "accBirth" : "string",
    "accCadate" : "string",
    "accChgdate" : "string",
    "accCname" : "string",
    "accCnyid" : "string",
    "accCrdate" : "string",
    "accDepid" : "string",
    "accDeposit" : 0.0,
    "accId" : 0,
    "accIdcard" : "string",
    "accIds" : "string",
    "accKind" : "string",
    "accNatid" : "string",
    "accPhoto" : "string",
    "accPwd" : "string",
    "accRemake" : "string",
    "accRleid" : "string",
    "accSex" : "string",
    "accStatus" : "string",
    "accStucode" : "string",
    "attribute1" : "string",
    "balance" : 0.0,
    "blnBalance" : 0.0,
    "bumen" : "string",
    "college" : "string",
    "crdCost" : 0,
    "crdId" : "string",
    "degreen" : "string",
    "duty" : "string",
    "dutyLevel" : "string",
    "guojia" : "string",
    "haveCard" : "string",
    "minzu" : "string",
    "mobile" : "string",
    "oprorAccId" : "string",
    "proId" : "string",
    "profeWid" : "string",
    "professional" : "string",
    "promptInfo" : "string",
    "studyYear" : "string",
    "subject" : "string",
    "type" : "string",
    "xb" : "string",
    "zhuangtai" : "string"
  }
}

2.4.6. 获取卡片打印内容

GET /tcommcardController/getPrintInfo
说明

用于证卡打印机打印卡片

参数
类型 名称 说明 类型

Query

accId
必填

账户ID

ref

响应
HTTP代码 说明 类型

200

OK

Tcommaccount

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/tcommcardController/getPrintInfo
请求 query
{
  "accId" : "ref"
}
HTTP响应示例
响应 200
{
  "accAddress" : "string",
  "accArea" : "string",
  "accAvdate" : "string",
  "accBankcode" : "string",
  "accBirth" : "string",
  "accCadate" : "string",
  "accChgdate" : "string",
  "accCname" : "string",
  "accCnyid" : "string",
  "accCrdate" : "string",
  "accDepid" : "string",
  "accDeposit" : 0.0,
  "accId" : 0,
  "accIdcard" : "string",
  "accIds" : "string",
  "accKind" : "string",
  "accNatid" : "string",
  "accPhoto" : "string",
  "accPwd" : "string",
  "accRemake" : "string",
  "accRleid" : "string",
  "accSex" : "string",
  "accStatus" : "string",
  "accStucode" : "string",
  "attribute1" : "string",
  "balance" : 0.0,
  "blnBalance" : 0.0,
  "bumen" : "string",
  "college" : "string",
  "crdCost" : 0,
  "crdId" : "string",
  "degreen" : "string",
  "duty" : "string",
  "dutyLevel" : "string",
  "guojia" : "string",
  "haveCard" : "string",
  "minzu" : "string",
  "mobile" : "string",
  "oprorAccId" : "string",
  "proId" : "string",
  "profeWid" : "string",
  "professional" : "string",
  "promptInfo" : "string",
  "studyYear" : "string",
  "subject" : "string",
  "type" : "string",
  "xb" : "string",
  "zhuangtai" : "string"
}

2.4.7. 查询卡

POST /tcommcardController/newFindByPageInclude
说明

分页查询用户所有卡信息

参数
类型 名称 说明 类型

Query

accountBlance
可选

number (double)

Query

crdAccid
可选

账户ID

integer (int32)

Query

crdCost
可选

卡工本费

integer (int32)

Query

crdCreatedate
可选

开通时间

string (date-time)

Query

crdFirstflag
可选

主副卡标志(1主卡,0副卡)

string

Query

crdId
可选

卡号

string

Query

crdLastdate
可选

上次修改时间

string (date-time)

Query

crdRoleId
可选

卡类型ID:学生卡、教师卡等

string

Query

crdStatus
可选

卡状态(1:正常,0:挂失,2:挂起,9:销户;缺省:1)

string

Query

crdStatusColor
可选

string

Query

crdTypid
可选

卡种类:01,默认物理卡

string

Query

limit
必填

每页记录条数

ref

Query

oprorAccId
可选

string

Query

page
必填

当前页码

ref

Query

stuCode
可选

string

Query

tcommaccount.accAddress
可选

家庭住址

string

Query

tcommaccount.accArea
可选

string

Query

tcommaccount.accAvdate
可选

帐户有效期截止日(截止到此日后则账户不可用):yyyy/MM/dd

string (date-time)

Query

tcommaccount.accBankcode
可选

银行卡号

string

Query

tcommaccount.accBirth
可选

人员生日:yyyy/MM/dd

string (date-time)

Query

tcommaccount.accCadate
可选

string (date-time)

Query

tcommaccount.accChgdate
可选

string (date-time)

Query

tcommaccount.accCname
可选

姓名

string

Query

tcommaccount.accCnyid
可选

国籍代码

string

Query

tcommaccount.accCrdate
可选

string (date-time)

Query

tcommaccount.accDepid
可选

部门或学院ID

string

Query

tcommaccount.accDeposit
可选

账户押金

number (double)

Query

tcommaccount.accId
可选

integer (int32)

Query

tcommaccount.accIdcard
可选

身份证号码/证件号码

string

Query

tcommaccount.accIds
可选

string

Query

tcommaccount.accKind
可选

string

Query

tcommaccount.accNatid
可选

民族代码

string

Query

tcommaccount.accPhoto
可选

string

Query

tcommaccount.accPwd
可选

string

Query

tcommaccount.accRemake
可选

账户备注信息

string

Query

tcommaccount.accRleid
可选

人员类别:字典表中对应的value

string

Query

tcommaccount.accSex
可选

性别:0:未知,1:男,2:女,9:未说明

string

Query

tcommaccount.accStatus
可选

帐户状态(0:正常,1:挂起,2:冻结,9:注销)

string

Query

tcommaccount.accStucode
可选

学工号

string

Query

tcommaccount.attribute1
可选

string

Query

tcommaccount.balance
可选

number (double)

Query

tcommaccount.blnBalance
可选

number (double)

Query

tcommaccount.bumen
可选

string

Query

tcommaccount.college
可选

string

Query

tcommaccount.crdCost
可选

integer (int32)

Query

tcommaccount.crdId
可选

string

Query

tcommaccount.degreen
可选

string

Query

tcommaccount.duty
可选

string

Query

tcommaccount.dutyLevel
可选

string

Query

tcommaccount.guojia
可选

string

Query

tcommaccount.haveCard
可选

string

Query

tcommaccount.minzu
可选

string

Query

tcommaccount.mobile
可选

string

Query

tcommaccount.oprorAccId
可选

string

Query

tcommaccount.proId
可选

string

Query

tcommaccount.profeWid
可选

string

Query

tcommaccount.professional
可选

string

Query

tcommaccount.promptInfo
可选

string

Query

tcommaccount.studyYear
可选

string

Query

tcommaccount.subject
可选

string

Query

tcommaccount.type
可选

string

Query

tcommaccount.xb
可选

string

Query

tcommaccount.zhuangtai
可选

string

Query

tcommcard
必填

ref

响应
HTTP代码 说明 类型

200

OK

object

201

Created

无内容

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/tcommcardController/newFindByPageInclude
请求 query
{
  "accountBlance" : 0.0,
  "crdAccid" : 0,
  "crdCost" : 0,
  "crdCreatedate" : "string",
  "crdFirstflag" : "string",
  "crdId" : "string",
  "crdLastdate" : "string",
  "crdRoleId" : "string",
  "crdStatus" : "string",
  "crdStatusColor" : "string",
  "crdTypid" : "string",
  "limit" : "ref",
  "oprorAccId" : "string",
  "page" : "ref",
  "stuCode" : "string",
  "tcommaccount.accAddress" : "string",
  "tcommaccount.accArea" : "string",
  "tcommaccount.accAvdate" : "string",
  "tcommaccount.accBankcode" : "string",
  "tcommaccount.accBirth" : "string",
  "tcommaccount.accCadate" : "string",
  "tcommaccount.accChgdate" : "string",
  "tcommaccount.accCname" : "string",
  "tcommaccount.accCnyid" : "string",
  "tcommaccount.accCrdate" : "string",
  "tcommaccount.accDepid" : "string",
  "tcommaccount.accDeposit" : 0.0,
  "tcommaccount.accId" : 0,
  "tcommaccount.accIdcard" : "string",
  "tcommaccount.accIds" : "string",
  "tcommaccount.accKind" : "string",
  "tcommaccount.accNatid" : "string",
  "tcommaccount.accPhoto" : "string",
  "tcommaccount.accPwd" : "string",
  "tcommaccount.accRemake" : "string",
  "tcommaccount.accRleid" : "string",
  "tcommaccount.accSex" : "string",
  "tcommaccount.accStatus" : "string",
  "tcommaccount.accStucode" : "string",
  "tcommaccount.attribute1" : "string",
  "tcommaccount.balance" : 0.0,
  "tcommaccount.blnBalance" : 0.0,
  "tcommaccount.bumen" : "string",
  "tcommaccount.college" : "string",
  "tcommaccount.crdCost" : 0,
  "tcommaccount.crdId" : "string",
  "tcommaccount.degreen" : "string",
  "tcommaccount.duty" : "string",
  "tcommaccount.dutyLevel" : "string",
  "tcommaccount.guojia" : "string",
  "tcommaccount.haveCard" : "string",
  "tcommaccount.minzu" : "string",
  "tcommaccount.mobile" : "string",
  "tcommaccount.oprorAccId" : "string",
  "tcommaccount.proId" : "string",
  "tcommaccount.profeWid" : "string",
  "tcommaccount.professional" : "string",
  "tcommaccount.promptInfo" : "string",
  "tcommaccount.studyYear" : "string",
  "tcommaccount.subject" : "string",
  "tcommaccount.type" : "string",
  "tcommaccount.xb" : "string",
  "tcommaccount.zhuangtai" : "string",
  "tcommcard" : "ref"
}
HTTP响应示例
响应 200
"object"

2.4.8. 开通卡片

POST /tcommcardController/savePl
说明

开通一卡通

参数
类型 名称 说明 类型

Query

accountBlance
可选

number (double)

Query

crdAccid
可选

账户ID

integer (int32)

Query

crdCost
可选

卡工本费

integer (int32)

Query

crdCreatedate
可选

开通时间

string (date-time)

Query

crdFirstflag
可选

主副卡标志(1主卡,0副卡)

string

Query

crdId
可选

卡号

string

Query

crdLastdate
可选

上次修改时间

string (date-time)

Query

crdRoleId
可选

卡类型ID:学生卡、教师卡等

string

Query

crdStatus
可选

卡状态(1:正常,0:挂失,2:挂起,9:销户;缺省:1)

string

Query

crdStatusColor
可选

string

Query

crdTypid
可选

卡种类:01,默认物理卡

string

Query

oprorAccId
可选

string

Query

stuCode
可选

string

Query

tcommaccount.accAddress
可选

家庭住址

string

Query

tcommaccount.accArea
可选

string

Query

tcommaccount.accAvdate
可选

帐户有效期截止日(截止到此日后则账户不可用):yyyy/MM/dd

string (date-time)

Query

tcommaccount.accBankcode
可选

银行卡号

string

Query

tcommaccount.accBirth
可选

人员生日:yyyy/MM/dd

string (date-time)

Query

tcommaccount.accCadate
可选

string (date-time)

Query

tcommaccount.accChgdate
可选

string (date-time)

Query

tcommaccount.accCname
可选

姓名

string

Query

tcommaccount.accCnyid
可选

国籍代码

string

Query

tcommaccount.accCrdate
可选

string (date-time)

Query

tcommaccount.accDepid
可选

部门或学院ID

string

Query

tcommaccount.accDeposit
可选

账户押金

number (double)

Query

tcommaccount.accId
可选

integer (int32)

Query

tcommaccount.accIdcard
可选

身份证号码/证件号码

string

Query

tcommaccount.accIds
可选

string

Query

tcommaccount.accKind
可选

string

Query

tcommaccount.accNatid
可选

民族代码

string

Query

tcommaccount.accPhoto
可选

string

Query

tcommaccount.accPwd
可选

string

Query

tcommaccount.accRemake
可选

账户备注信息

string

Query

tcommaccount.accRleid
可选

人员类别:字典表中对应的value

string

Query

tcommaccount.accSex
可选

性别:0:未知,1:男,2:女,9:未说明

string

Query

tcommaccount.accStatus
可选

帐户状态(0:正常,1:挂起,2:冻结,9:注销)

string

Query

tcommaccount.accStucode
可选

学工号

string

Query

tcommaccount.attribute1
可选

string

Query

tcommaccount.balance
可选

number (double)

Query

tcommaccount.blnBalance
可选

number (double)

Query

tcommaccount.bumen
可选

string

Query

tcommaccount.college
可选

string

Query

tcommaccount.crdCost
可选

integer (int32)

Query

tcommaccount.crdId
可选

string

Query

tcommaccount.degreen
可选

string

Query

tcommaccount.duty
可选

string

Query

tcommaccount.dutyLevel
可选

string

Query

tcommaccount.guojia
可选

string

Query

tcommaccount.haveCard
可选

string

Query

tcommaccount.minzu
可选

string

Query

tcommaccount.mobile
可选

string

Query

tcommaccount.oprorAccId
可选

string

Query

tcommaccount.proId
可选

string

Query

tcommaccount.profeWid
可选

string

Query

tcommaccount.professional
可选

string

Query

tcommaccount.promptInfo
可选

string

Query

tcommaccount.studyYear
可选

string

Query

tcommaccount.subject
可选

string

Query

tcommaccount.type
可选

string

Query

tcommaccount.xb
可选

string

Query

tcommaccount.zhuangtai
可选

string

Query

tcommcard
必填

ref

响应
HTTP代码 说明 类型

200

OK

JsonResultExt

201

Created

无内容

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/tcommcardController/savePl
请求 query
{
  "accountBlance" : 0.0,
  "crdAccid" : 0,
  "crdCost" : 0,
  "crdCreatedate" : "string",
  "crdFirstflag" : "string",
  "crdId" : "string",
  "crdLastdate" : "string",
  "crdRoleId" : "string",
  "crdStatus" : "string",
  "crdStatusColor" : "string",
  "crdTypid" : "string",
  "oprorAccId" : "string",
  "stuCode" : "string",
  "tcommaccount.accAddress" : "string",
  "tcommaccount.accArea" : "string",
  "tcommaccount.accAvdate" : "string",
  "tcommaccount.accBankcode" : "string",
  "tcommaccount.accBirth" : "string",
  "tcommaccount.accCadate" : "string",
  "tcommaccount.accChgdate" : "string",
  "tcommaccount.accCname" : "string",
  "tcommaccount.accCnyid" : "string",
  "tcommaccount.accCrdate" : "string",
  "tcommaccount.accDepid" : "string",
  "tcommaccount.accDeposit" : 0.0,
  "tcommaccount.accId" : 0,
  "tcommaccount.accIdcard" : "string",
  "tcommaccount.accIds" : "string",
  "tcommaccount.accKind" : "string",
  "tcommaccount.accNatid" : "string",
  "tcommaccount.accPhoto" : "string",
  "tcommaccount.accPwd" : "string",
  "tcommaccount.accRemake" : "string",
  "tcommaccount.accRleid" : "string",
  "tcommaccount.accSex" : "string",
  "tcommaccount.accStatus" : "string",
  "tcommaccount.accStucode" : "string",
  "tcommaccount.attribute1" : "string",
  "tcommaccount.balance" : 0.0,
  "tcommaccount.blnBalance" : 0.0,
  "tcommaccount.bumen" : "string",
  "tcommaccount.college" : "string",
  "tcommaccount.crdCost" : 0,
  "tcommaccount.crdId" : "string",
  "tcommaccount.degreen" : "string",
  "tcommaccount.duty" : "string",
  "tcommaccount.dutyLevel" : "string",
  "tcommaccount.guojia" : "string",
  "tcommaccount.haveCard" : "string",
  "tcommaccount.minzu" : "string",
  "tcommaccount.mobile" : "string",
  "tcommaccount.oprorAccId" : "string",
  "tcommaccount.proId" : "string",
  "tcommaccount.profeWid" : "string",
  "tcommaccount.professional" : "string",
  "tcommaccount.promptInfo" : "string",
  "tcommaccount.studyYear" : "string",
  "tcommaccount.subject" : "string",
  "tcommaccount.type" : "string",
  "tcommaccount.xb" : "string",
  "tcommaccount.zhuangtai" : "string",
  "tcommcard" : "ref"
}
HTTP响应示例
响应 200
{
  "code" : 0,
  "data" : "object",
  "message" : "string"
}

2.4.9. 注销卡片

POST /tcommcardController/toCancel
说明

单张或批量销卡

参数
类型 名称 说明 类型

Query

ids
必填

卡号字符串,用逗号拼接

string

Query

oprorAccId
必填

操作人账户ID

string

响应
HTTP代码 说明 类型

200

OK

JsonResult

201

Created

无内容

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/tcommcardController/toCancel
请求 query
{
  "ids" : "string",
  "oprorAccId" : "string"
}
HTTP响应示例
响应 200
{
  "code" : "string",
  "data" : "object",
  "message" : "string"
}

2.4.10. 解挂卡片

POST /tcommcardController/toHang
说明

单张或批量解挂

参数
类型 名称 说明 类型

Query

ids
必填

卡号字符串,多张卡用逗号拼接

string

Query

oprorAccId
必填

操作人账户ID

string

响应
HTTP代码 说明 类型

200

OK

JsonResult

201

Created

无内容

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/tcommcardController/toHang
请求 query
{
  "ids" : "string",
  "oprorAccId" : "string"
}
HTTP响应示例
响应 200
{
  "code" : "string",
  "data" : "object",
  "message" : "string"
}

2.4.11. 挂失卡片

POST /tcommcardController/toLoss
说明

单张或批量挂失

参数
类型 名称 说明 类型

Query

ids
必填

卡号字符串,多张卡用逗号拼接

string

Query

oprorAccId
必填

操作人账户ID

string

响应
HTTP代码 说明 类型

200

OK

JsonResult

201

Created

无内容

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/tcommcardController/toLoss
请求 query
{
  "ids" : "string",
  "oprorAccId" : "string"
}
HTTP响应示例
响应 200
{
  "code" : "string",
  "data" : "object",
  "message" : "string"
}

2.4.12. 加卡/补卡/换卡

POST /tcommcardController/toSave
说明

加卡/补卡/换卡

参数
类型 名称 说明 类型

Body

tcommcard
必填

Tcommcard

响应
HTTP代码 说明 类型

200

OK

JsonResultExt

201

Created

无内容

401

Unauthorized

无内容

403

Forbidden

无内容

404

Not Found

无内容

消耗
  • application/json

生成
  • /

HTTP请求示例
请求 path
/tcommcardController/toSave
请求 body
{
  "accountBlance" : 0.0,
  "crdAccid" : 0,
  "crdCost" : 0,
  "crdCreatedate" : "string",
  "crdFirstflag" : "string",
  "crdId" : "string",
  "crdLastdate" : "string",
  "crdRoleId" : "string",
  "crdStatus" : "string",
  "crdStatusColor" : "string",
  "crdTypid" : "string",
  "oprorAccId" : "string",
  "stuCode" : "string",
  "tcommaccount" : {
    "accAddress" : "string",
    "accArea" : "string",
    "accAvdate" : "string",
    "accBankcode" : "string",
    "accBirth" : "string",
    "accCadate" : "string",
    "accChgdate" : "string",
    "accCname" : "string",
    "accCnyid" : "string",
    "accCrdate" : "string",
    "accDepid" : "string",
    "accDeposit" : 0.0,
    "accId" : 0,
    "accIdcard" : "string",
    "accIds" : "string",
    "accKind" : "string",
    "accNatid" : "string",
    "accPhoto" : "string",
    "accPwd" : "string",
    "accRemake" : "string",
    "accRleid" : "string",
    "accSex" : "string",
    "accStatus" : "string",
    "accStucode" : "string",
    "attribute1" : "string",
    "balance" : 0.0,
    "blnBalance" : 0.0,
    "bumen" : "string",
    "college" : "string",
    "crdCost" : 0,
    "crdId" : "string",
    "degreen" : "string&qu