内网备单发卡接口

@author：Csa
请求URL
https://api.mytijian.com/open-api/V2/ws/card/hisSendCard?accessToken=ACCESS_TOKEN&nonce=NONCE&sign=SIGN
请求协议：HTTPS
请求方式：POST
需要签名: 是
URL参数:

参数名 是否必须 类型 说明
accessToken 是 string 当前有效的accessToken
nonce 是 string 当前有效的nonce
sign 是 string 数据sign值
POST参数示例
  1. {
  2.     "examineeId": 10625777, // 体检人id
  3.     "hisExamineeNum": "adddffffff-FM",//内网体检号
  4.     "companyId": 4431289,//平台单位id
  5.     "cardMealDtoList": [//卡中套餐集合
  6.         {
  7.             "mealId": 573317,//平台套餐id
  8.             "hospitalId": 147,//体检中心id
  9.             "isMealForSelf": true,//是否仅持有人可用，true是，false否。
  10.             "isMealForFamily": false//是否家属可用，true是，false否。
  11.         }
  12.     ],
  13.     "cardCapacity": 1000,//卡余额
  14.     "cardValidityStartTime": "2022-03-02 10:00:00",//卡有效期开始时间
  15.     "cardValidityEndTime": "2022-05-02 10:00:00"//卡有效期结束时间
  16.     "hidePrice":false// 是否发隐价卡, true 发送隐价卡，false 不隐藏
  17. }

正确返回示例:

  1. {
  2.     "data": {
  3.         "cardId": 4341991 // 平台卡id
  4.     },
  5.     "msg": "success",
  6.     "success": "T"
  7. }

撤卡接口

@author：Csa
请求URL
https://api.mytijian.com/open-api/V2/ws/card/hisRevokeCard?accessToken=ACCESS_TOKEN&nonce=NONCE&sign=SIGN
请求协议：HTTPS
请求方式：POST
需要签名: 是
URL参数:

参数名 是否必须 类型 说明
accessToken 是 string 当前有效的accessToken
nonce 是 string 当前有效的nonce
sign 是 string 数据sign值
POST参数示例
  1. {
  2.     "cardIds":[4341993]//卡id集合,
  3.     "cardNums"['2323','232323']
  4.     "removeHisExaminee":false
  5. }

cardIds和cardNums 二选一
|参数名|是否必须|类型|说明|
| —————— | —————— | —————— | —————— |
|cardIds |是 |string | 体检卡id，后续废弃，使用cardNums|
|cardNums |是 |string | 体检卡号 |
|removeHisExaminee |是 |boolean | 是否要删除内网体检号 |

正确返回示例:

  1. {
  2.     "data": {
  3.         "successCardIds": [4341993]//成功的卡id集合
  4.     },
  5.     "msg": "success",
  6.     "success": "T"
  7. }

内网备单（发卡）

请求URL
https://api.mytijian.com/open-api/V2/ws/card/prepare?accessToken=ACCESS_TOKEN&nonce=NONCE&sign=SIGN

请求协议：HTTPS
请求方式：POST
需要签名: 是
URL参数:

参数名 是否必须 类型 说明
accessToken 是 string 当前有效的accessToken
nonce 是 string 当前有效的nonce
sign 是 string 数据sign值
POST参数示例
  1. {
  2.     "examineeId": 10625777, // 体检人id
  3.     "hisExamineeNum": "adddffffff-FM",//内网体检号
  4.     "companyId": 1234,
  5.     "cardCapacity": 1000,//卡余额
  6.     "cardValidityStartTime": "2022-03-02 10:00:00",//卡有效期开始时间
  7.     "cardValidityEndTime": "2022-05-02 10:00:00"//卡有效期结束时间,
  8.     "hisGroupCode":"内网分组code",
  9.     "hidePrice":false// 是否发隐价卡, true 发送隐价卡，false 不隐藏
  10. }

正确返回示例:

  1. {
  2.     "data": {
  3.         "cardNum": "1212121212"
  4.     },
  5.     "msg": "success",
  6.     "success": "T"
  7. }

修改个人限额

请求URL
https://api.mytijian.com/open-api/V2/ws/card/modify?accessToken=ACCESS_TOKEN&nonce=NONCE&sign=SIGN

请求协议：HTTPS
请求方式：POST
需要签名: 是
URL参数:

参数名 是否必须 类型 说明
accessToken 是 string 当前有效的accessToken
nonce 是 string 当前有效的nonce
sign 是 string 数据sign值
POST参数示例
  1. {
  3.     "hisExamineeNum": "adddffffff-FM",
  4.     "cardCapacity": 1000
  5. }
参数名 是否必须 类型 说明
hisExamineeNum 是 string 内网体检号
cardCapacity 否 int 新的余额

正确返回示例:

  1. {
  2.     "data": {
  4.     },
  5.     "msg": "success",
  6.     "success": "T"
  7. }

内网取消备单

注意目前体检号只与天瑞的接口交互的时候用
请求URL
https://api.mytijian.com/open-api/V2/ws/card/cancelPrepare?accessToken=ACCESS_TOKEN&nonce=NONCE&sign=SIGN

请求协议：HTTPS
请求方式：POST
需要签名: 是
URL参数:

参数名 是否必须 类型 说明
accessToken 是 string 当前有效的accessToken
nonce 是 string 当前有效的nonce
sign 是 string 数据sign值
POST参数示例
  1. {
  2.     "hisExamineeNum": "adddffffff-FM",
  3.     "cardNum":"121212",
  4.     "orderNum":"23232323",
  5. }

hisExamineeNum 与cardNum,orderNum 选一

参数名 是否必须 类型 说明
hisExamineeNum 是 string 体检号
cardNum 否 string 体检卡号
orderNum 否 string 订单号

正确返回示例:

  1. {
  2.     "data": {
  3.         "hisExamineeNum": "1212121212"//t
  4.     },
  5.     "msg": "success",
  6.     "success": "T"
  7. }
文档更新时间: 2025-07-04 17:59