医易签

9.1 新增或更新系统账户数据

测试中

POST

/v1/open/hospital/hospital-users/update-by-id-card

此接口可同步his系统的账户到签署平台；以身份证号做标识，存在则更新，不存在则新建。
科室不存在会自动创建
院区需管理员在签署平台手动维护

请求参数

Authorization

Query 参数

access_token

string

必需

授权码；正式环境联系签署平台方获取

默认值:

3e9dec5f-4a9d-4af8-8abc-23e4675a1eb6

Header 参数

X-Signit-App-Id

string

必需

应用id；正式环境联系签署平台方获取

默认值:

1931fabdb516e66ca2f8c42691a

Body 参数application/json

hospitalDepartment

object

单科室参数

必需

departmentName

string

科室名称

必需

departmentId

string

科室代码

必需

areaCode

string

院区代码

可选

未传时使用默认院区

hospitalDoctor

object

必需

jobId

string

工号

必需

name

string

姓名

必需

account

string

手机号

必需

idCard

string

身份证号

必需

position

string

职位

必需

multiHospitalDepartment

array [object {3}]

必需

单一科室、多科室均可传此参数，此参数比hospitalDepartment优先生效

departmentName

string

科室名称

必需

departmentId

string

科室代码

必需

areaCode

string

院区代码

可选

未传时使用默认院区

status

string

账户状态（暂未实现）

可选

ENABLE = 启用（默认启用状态）
DISABLE = 禁用
DELETE = 删除

示例

{
  "hospitalDepartment": {
    "departmentName": "科室_{{$helper.autoIncrementEnvVar}}",
    "departmentId": "dept_{{$helper.autoIncrementEnvVar}}",
    "areaCode": "A000"
  },
  "hospitalDoctor": {
    "jobId": "{{$number.int(min=10000,max=99999)}}",
    "name": "{{$person.fullName}}",
    "account": "{% mock 'phone' %}",
    "idCard": "{% mock 'id' %}",
    "position": "两年半的实习生"
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://m1.apifoxmock.com/m1/4604434-0-default/v1/open/hospital/hospital-users/update-by-id-card?access_token=' \
--header 'X-Signit-App-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "hospitalDepartment": {
        "departmentName": "科室_{{$helper.autoIncrementEnvVar}}",
        "departmentId": "dept_{{$helper.autoIncrementEnvVar}}",
        "areaCode": "A000"
    },
    "hospitalDoctor": {
        "jobId": "{{$number.int(min=10000,max=99999)}}",
        "name": "{{$person.fullName}}",
        "account": "{% mock '\''phone'\'' %}",
        "idCard": "{% mock '\''id'\'' %}",
        "position": "两年半的实习生"
    }
}'

返回响应

🟢200成功

application/json

Body

code

string

响应码

必需

100870000 = 成功
其他 = 失败

message

string

响应消息

必需

示例

{
  "code": "100870000",
  "message": "操作成功",
  "hospitalDoctor": {
    "userWsid": "WSID_EUSR_00000195642ca9126e4a1b5c5b280001",
    "hisId": "87446",
    "jobId": "87446",
    "position": "两年半的实习生",
    "account": "18112457857",
    "name": "充子豪",
    "idCard": "210000199710045538",
    "createdDatetime": 1741142403213
  }
}

🟠400参数不正确

修改于 2025-04-14 06:56:18

8.1 获取患者签名图片

无外观