医易签

4.4 医护执行签名

测试中

POST

/v1/open/envelope/pub/envelopes/doctor-sign

请求参数

Authorization

Query 参数

access_token

string

必需

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

默认值:

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

Header 参数

X-Signit-App-Id

string

必需

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

默认值:

1931fabdb516e66ca2f8c42691a

Body 参数application/json

customTag

string

业务编号

必需

jobId

string

工号

必需

支持传身份证号

mode

string

签署模式

必需

NORMAL - 显示签署，需传证书密码（PIN）
AUTO - 静默签署

string

证书密码

可选

显示签署时必传；密码使用aes加密后转base64，密钥为jobId的值
示例：BASE64(AES(密码原文,jobId))

示例

{
  "customTag": "string",
  "jobId": "string",
  "mode": "string",
  "pin": "string"
}

示例代码

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/envelope/pub/envelopes/doctor-sign?access_token=' \
--header 'X-Signit-App-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "customTag": "string",
    "jobId": "string",
    "mode": "string",
    "pin": "string"
}'

返回响应

🟢200成功

application/json

Body

code

string

响应码

必需

100100000 = 成功，其他 = 失败

message

string

响应消息

必需

userMessage

string

异常响应详细消息

可选

示例

异常示例成功示例

{
  "code": "100601700",
  "message": "信封不允许签署",
  "errorWsid": "WSID_COMM_000001955ee4d8b16e4a1b5c5b280001",
  "userMessage": "信封不允许签署 <-- 文件已签署成功，请刷新查看！",
  "developerMessage": "信封不允许签署 <-- 文件已签署成功，请刷新查看！",
  "moreInfo": "/errors/WSID_COMM_000001955ee4d8b16e4a1b5c5b280001",
  "links": []
}

🟠400参数不正确

修改于 2025-03-04 02:07:07

4.3 查询患者文件签名的图片

4.5 使用文件ID验签