his查询人数控制

https://api.mytijian.com/open-api/V2/ws/counter/queryCounterCapacity?accessToken=ACCESS_TOKEN
请求协议：HTTPS
请求方式：POST
需要签名: 否
URL参数:

参数名 是否必须 类型 说明
accessToken 是 string 当前有效的accessToken
POST参数示例
  1. {
  2.     "startDate":"2020-03-01",
  3.     "endDate":"2020-03-01"
  4. }
请求参数说明：
参数名 是否必须 类型 说明
startDate 是 string 开始时间
endDate 是 string 结束时间
companyId 否 int 平台单位id

正确返回示例:

  1. {
  2.     "data": [
  3.         {
  4.             "date": "2020-03-01",
  5.             "week": 7,
  6.             "periodExamItemDtoList": [
  7.                 {
  8.                     "examItemCapacityDtoList": [
  9.                         {
  10.                             "period": 1244,
  11.                             "expandNum": 0,
  12.                             "occupyNum": 0,
  13.                             "periodName": "7:00-8:00",
  14.                             "availableNum": 0,
  15.                             "maxNum": 0,
  16.                             "usedNum": 0
  17.                         },
  18.                         {
  19.                             "period": 4001373,
  20.                             "expandNum": 0,
  21.                             "occupyNum": 0,
  22.                             "periodName": "8:00-9:00",
  23.                             "availableNum": 0,
  24.                             "maxNum": 0,
  25.                             "usedNum": 0
  26.                         },
  27.                         {
  28.                             "period": 4002346,
  29.                             "expandNum": 0,
  30.                             "occupyNum": 0,
  31.                             "periodName": "12:00-14:00",
  32.                             "availableNum": 0,
  33.                             "maxNum": 0,
  34.                             "usedNum": 0
  35.                         }
  36.                     ],
  37.                     "examItemName": "人数控制测试",
  38.                     "examItemId": 4142065
  39.                 },
  40.                 {
  41.                     "examItemCapacityDtoList": [
  42.                         {
  43.                             "period": 1244,
  44.                             "expandNum": 0,
  45.                             "occupyNum": 0,
  46.                             "capacityId": 661209,
  47.                             "periodName": "7:00-8:00",
  48.                             "availableNum": 1000,
  49.                             "maxNum": 1000,
  50.                             "usedNum": 0
  51.                         },
  52.                         {
  53.                             "period": 4001373,
  54.                             "expandNum": 0,
  55.                             "occupyNum": 4,
  56.                             "capacityId": 292627,
  57.                             "periodName": "8:00-9:00",
  58.                             "availableNum": 996,
  59.                             "maxNum": 1000,
  60.                             "usedNum": 0
  61.                         },
  62.                         {
  63.                             "period": 4002346,
  64.                             "expandNum": 0,
  65.                             "occupyNum": 0,
  66.                             "capacityId": 661208,
  67.                             "periodName": "12:00-14:00",
  68.                             "availableNum": 1000,
  69.                             "maxNum": 1000,
  70.                             "usedNum": 0
  71.                         }
  72.                     ],
  73.                     "examItemId": -1
  74.                 }
  75.             ]
  76.         }
  77.     ],
  78.     "msg": "success",
  79.     "success": "T"
  80. }
返回参数说明:
参数名 类型 说明
success String T成功，F失败
errCode String 错误码，只有失败的时候才有
msg String 描述消息
data List(CounterCapacityDto) 人数控制返回对象集合
CounterCapacityDto对象说明
参数名 是否必须 类型 说明
date 是 string 日期，格式yyyy-MM-dd
week 是 int 1：周一，，，7：周七
periodExamItemDtoList 是 List(PeriodExamItemDto) 时段单项集合
PeriodExamItemDto对象说明
参数名 是否必须 类型 说明
examItemId 是 int 控制项id（-1：为全局控制项）
examItemName 否 string 控制项名称（-1无名称）
examItemCapacityDtoList 是 List(ExamItemCapacityDto) 项目容量明细
ExamItemCapacityDto对象说明
参数名 是否必须 类型 说明
usedNum 是 int 预约数
maxNum 是 string 限额或容量
availableNum 是 int 可约数
expandNum 是 int 扩容数
occupyNum 是 int 占用数
period 是 int 时段id
periodName 是 string 时段名称

his人数控制同步至平台接口

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

参数名 是否必须 类型 说明
accessToken 是 string 当前有效的accessToken
nonce 是 string 当前有效的nonce
sign 是 string 数据sign值
POST参数示例
  1. {
  2.     "type": 1,
  3.     "capacityConfigDtoList": [
  4.         {
  5.             "capacityPeriodSettingDetailDtoList": [
  6.                 {
  7.                     "period": "1244",
  8.                     "itemSettings": [
  9.                         {
  10.                             "itemName": "-1",
  11.                             "capacityCellDto": {
  12.                                 "reserveNum": 20,
  13.                                 "limit": 20
  14.                             }
  15.                         },
  16.                         {
  17.                             "itemName": "男项",
  18.                             "capacityCellDto": {
  19.                                 "reserveNum": 10,
  20.                                 "limit": 10
  21.                             }
  22.                         },
  23.                         {
  24.                             "itemName": "女项",
  25.                             "capacityCellDto": {
  26.                                 "reserveNum": 10,
  27.                                 "limit": 10
  28.                             }
  29.                         }
  30.                     ]
  31.                 },
  32.                 {
  33.                     "period": "4001373",
  34.                     "itemSettings": [
  35.                         {
  36.                             "itemName": "-1",
  37.                             "capacityCellDto": {
  38.                                 "reserveNum": 0,
  39.                                 "limit": 0
  40.                             }
  41.                         }
  42.                     ]
  43.                 },
  44.                 {
  45.                     "period": "4002346",
  46.                     "itemSettings": [
  47.                         {
  48.                             "itemName": "-1",
  49.                             "capacityCellDto": {
  50.                                 "reserveNum": 0,
  51.                                 "limit": 0
  52.                             }
  53.                         }
  54.                     ]
  55.                 }
  56.             ],
  57.             "date": "2020-06-26"
  58.         }
  59.     ]
  60. }
请求参数说明：
参数名 是否必须 类型 说明
type 是 int 1:体检中心容量设置，2:单位容量设置
capacityConfigDtoList 是 List(CapacityConfigDto) 容量设置集合
CapacityConfigDto对象说明
参数名 是否必须 类型 说明
date 是 string 日期，格式：yyyy-MM-dd
companyId 否 int 单位id,单位容量设置必传
capacityPeriodSettingDetailDtoList 是 List(CapacityPeriodSettingDto) 容量时段设置集合
CapacityPeriodSettingDto对象说明
参数名 是否必须 类型 说明
period 是 string 时段id字符串
itemSettings 是 List（ItemSettingDto） 单项设置集合
CapacityPeriodSettingDto对象说明
参数名 是否必须 类型 说明
itemName 是 string 单项名称，-1为人数项
capacityCellDto 是 CapacityCellDto 容量单元对象
CapacityCellDto对象说明
参数名 是否必须 类型 说明
reserveNum 是 int 预留数
limit 是 int 限额数

根据时段名称查询时段信息

https://api.mytijian.com/open-api/V2/ws/counter/queryPeriodSetting?accessToken=ACCESS_TOKEN
请求协议：HTTPS
请求方式：POST
需要签名: 否
URL参数:

参数名 是否必须 类型 说明
accessToken 是 string 当前有效的accessToken
POST参数示例
  1. {
  2.     "periodName":"7:00-8:00"
  3. }
请求参数说明：
参数名 是否必须 类型 说明
periodName 是 string 时段名称

正确返回示例:

  1. {
  2.     "data": {
  3.         "hospitalId": 197,
  4.         "name": "7:00-8:00",
  5.         "id": 1244
  6.     },
  7.     "msg": "success",
  8.     "success": "T"
  9. }
返回参数说明:
参数名 类型 说明
success String T成功，F失败
errCode String 错误码，只有失败的时候才有
msg String 描述消息
data HospitalPeriodSettingDto 时段信息对象
HospitalPeriodSettingDto对象说明
参数名 是否必须 类型 说明
hospitalId 是 int 体检中心id
name 是 string 体检中心时段名称
id 是 int 体检中心时段id

单位人数控制详情

https://api.mytijian.com/open-api/V2/ws/counter/queryCompanyCounterDetail?accessToken=ACCESS_TOKEN
请求协议：HTTPS
请求方式：POST
需要签名: 否
URL参数:

参数名 是否必须 类型 说明
accessToken 是 string 当前有效的accessToken
POST参数示例
  1. {
  2.     "companyIds":[4400508],
  3.     "date":"2020-05-26"
  4. }
请求参数说明：
参数名 是否必须 类型 说明
companyIds 是 List(int) 单位id集合
date 是 string 日期，格式yyyy-MM-dd

正确返回示例:

  1. {
  2.     "data": [
  3.         {
  4.             "capacityPeriodSettingDetailDtoList": [
  5.                 {
  6.                     "itemSettings": [
  7.                         {
  8.                             "item": "男项",
  9.                             "capacityCellDto": {
  10.                                 "limit": -1,
  11.                                 "reserveNum": -1,
  12.                                 "usedNum": 0
  13.                             }
  14.                         },
  15.                         {
  16.                             "item": "女项",
  17.                             "capacityCellDto": {
  18.                                 "limit": -1,
  19.                                 "reserveNum": -1,
  20.                                 "usedNum": 0
  21.                             }
  22.                         },
  23.                         {
  24.                             "item": "-1",
  25.                             "capacityCellDto": {
  26.                                 "limit": -1,
  27.                                 "reserveNum": 1,
  28.                                 "usedNum": 0
  29.                             }
  30.                         }
  31.                     ],
  32.                     "period": "1244"
  33.                 },
  34.                 {
  35.                     "itemSettings": [
  36.                         {
  37.                             "item": "男项",
  38.                             "capacityCellDto": {
  39.                                 "limit": -1,
  40.                                 "reserveNum": -1,
  41.                                 "usedNum": 0
  42.                             }
  43.                         },
  44.                         {
  45.                             "item": "女项",
  46.                             "capacityCellDto": {
  47.                                 "limit": -1,
  48.                                 "reserveNum": -1,
  49.                                 "usedNum": 0
  50.                             }
  51.                         },
  52.                         {
  53.                             "item": "-1",
  54.                             "capacityCellDto": {
  55.                                 "limit": -1,
  56.                                 "reserveNum": -1,
  57.                                 "usedNum": 0
  58.                             }
  59.                         }
  60.                     ],
  61.                     "period": "4001373"
  62.                 },
  63.                 {
  64.                     "itemSettings": [
  65.                         {
  66.                             "item": "男项",
  67.                             "capacityCellDto": {
  68.                                 "limit": -1,
  69.                                 "reserveNum": -1,
  70.                                 "usedNum": 0
  71.                             }
  72.                         },
  73.                         {
  74.                             "item": "女项",
  75.                             "capacityCellDto": {
  76.                                 "limit": -1,
  77.                                 "reserveNum": -1,
  78.                                 "usedNum": 0
  79.                             }
  80.                         },
  81.                         {
  82.                             "item": "-1",
  83.                             "capacityCellDto": {
  84.                                 "limit": -1,
  85.                                 "reserveNum": -1,
  86.                                 "usedNum": 0
  87.                             }
  88.                         }
  89.                     ],
  90.                     "period": "4002346"
  91.                 }
  92.             ],
  93.             "date": "2020-05-26",
  94.             "companyId": 4400508
  95.         }
  96.     ],
  97.     "msg": "success",
  98.     "success": "T"
  99. }
返回参数说明:
参数名 类型 说明
success String T成功，F失败
errCode String 错误码，只有失败的时候才有
msg String 描述消息
data List(CapacityConfigDto) 容量配置集合
CapacityConfigDto对象说明
参数名 是否必须 类型 说明
date 是 string 日期，格式：yyyy-MM-dd
companyId 是 int 单位id
capacityPeriodSettingDetailDtoList 是 List(CapacityPeriodSettingDto) 容量时段设置详情集合，若当天该单位没有设置过容量，则返回空数组
CapacityPeriodSettingDto对象说明
参数名 是否必须 类型 说明
period 是 string 时段id字符串
itemSettings 是 List（ItemSettingDto） 单项设置集合
CapacityPeriodSettingDto对象说明
参数名 是否必须 类型 说明
itemName 是 string 单项名称，-1为人数项
capacityCellDto 是 CapacityCellDto 容量单元对象
CapacityCellDto对象说明
参数名 是否必须 类型 说明
reserveNum 是 int 预留数，-1为没有设置
usedNum 是 int 已预约数
limit 是 int 限额数，-1为没有设置
文档更新时间: 2025-07-04 17:59