医易签
  1. 2.数据签名
医易签
  • 一、CA无纸化签署接口
    • 1.CA扫码登录
      • 1.1 创建CA扫码登录二维码
      • 1.2 查询扫码登陆任务的状态信息
      • 1.3 扫码登录回调
    • 2.数据签名
      • 2.1 数据签名接口
        POST
      • 2.2 数据签名回传_主动查询
        GET
      • 2.3 数据快捷签名
        POST
      • 2.4 数据手动签名
        POST
      • 2.4 数据签验证接口
        POST
    • 3.数据签名v2
      • 3.1 发起数据异步签名
      • 3.2 发起数据同步签名
      • 3.3 查询数据签名结果
      • 3.4 医护执行签名
    • 4.PDF版式文书签署
      • 4.1 ⽂件异步签署
      • 4.2 ⽂件同步签署
      • 4.3 查询患者文件签名的图片
      • 4.4 医护执行签名
      • 4.5 使用文件ID验签
      • 4.6 上传文件验签
      • 4.7 查询文件签名记录
    • 5.PDF版式文件分步签署
      • 5.1 发起签署流程
      • 5.2 发起签名或填写表单
      • 5.3 完成签署流程（手动模式调用）
    • 6.用户信息查询
      • 6.1 查询⽤户⼿写签名图⽚
      • 6.2 查询指定⽤户的⼿机盾设置
      • 6.3 查询⽤户⼿写签名图⽚
    • 7.WebHook回调
      • WebHook回调接口文档说明
      • 7.1 Webhook回调接口：数据签名示例
      • 7.2 Webhook回调接口：文件签名回调示例
      • 7.3 Webhook回调接口：数据签名v2回调示例
    • 8.患者信息查询
      • 8.1 获取患者签名图片
    • 9.数据同步
      • 9.1 新增或更新系统账户数据
    • 10.归档签
      • 无外观
    • Delphi接口调用示例代码
      • Delphi接口调用示例代码
  • 二、无纸化病案系统接口
    • 1.基础接口
      • 三方系统-科室推送 （自定义结构）
      • 三方系统-推送医护信息（自定义结构）
      • 三方系统-推送首页数据 （自定义结构）
      • 三方系统-推送患者信息 （自定义结构）
      • 三方推送-医保ICD对照数据(自定义结构)
      • 三方系统-推送医保结算清单信息
      • 三方系统-推送医嘱信息（自定义结构）
      • 三方系统-推送医嘱对照细目（药品，检查，检验）
    • 2.病案归档
      • 三方系统-追加文档 (自定义结构)
      • 三方系统-推送文档记录（非文件）
      • 三方系统-删除文件
    • 3.病案共享
      • 三方系统-获取患者文件
      • 三方系统-获取患者文件组
    • 4.数据统计
    • 5.消息订阅
      • 病案状态消息变化
      • 病案质控消息变化
    • 6.病案复印
  1. 2.数据签名

2.1 数据签名接口

POST
/v1/open/hospital/hospitals/data-signature-records/flow
创建⼀条数据签名记录；⽤户开启静默签时会直接返回签名后的结果。

请求参数

Authorization
Query 参数
access_token
string 
必需
授权码；正式环境联系签署平台方获取
默认值:
3e9dec5f-4a9d-4af8-8abc-23e4675a1eb6
Header 参数
Content-Type
string 
可选
示例值:
application/json
X-Signit-App-Id
string 
必需
应用id；正式环境联系签署平台方获取
默认值:
1931fabdb516e66ca2f8c42691a
Body 参数application/json
businessInfo
object 
业务信息
必需
customTag
string 
调⽤⽅⾃定义唯⼀编号
必需
doctorId
string 
签名医⽣的⼯号
必需
可以传医生身份证号值
doctorName
string 
签名医⽣的姓名
必需
serviceType
string 
业务类型名称（等同业务模板的名 称）
必需
departmentName
string 
科室名称
必需
departmentId
string 
科室代码
可选
patientId 
string 
患者id
可选
patientIdCard
string 
患者身份证号
可选
patientAge
string 
患者年龄
可选
patientName
string 
患者姓名
可选
patientSex
integer 
患者性别（0表示男， 1表示⼥ 2 表 示不确定）
可选
admissionNo
string 
住院号
可选
bedNo 
string 
床号
可选
signData
object 
数据签名信息
必需
signData
string 
待签原⽂
必需
dataType
string 
待签原⽂的数据格式类型，⽤于标识 待签原⽂的数据类型； 枚举：STRING、JSON、XML、 HTML、EMT
可选
signAlgorithm
string 
签名算法；
可选
archivedAfterSign ed
boolean 
签名成功后是否归档（归档后相同 customTag不能再发起签名）
可选
requiredAutoSign
boolean 
当前签名需要⾃动签署；传true时， 当⽤户未开启静默签会返回错误信息
可选
extraParam
string 
扩展参数
可选
调用方可在此属性中传递自定义的扩展参数。在签署完成后的回调中会原样返回
示例
{
    "businessInfo": {
        "customTag": "Customg20245202002",
        "doctorId": "job_test",
        "serviceType": "护理记录单",
        "departmentName": "呼吸内科",
        "patientId": "A01251622",
        "patientIdCard": "51072319960103441",
        "patientAge": "18",
        "patientName": "张三五",
        "patientSex": 0,
        "admissionNo": "0000000",
        "bedNo": "A0108"
    },
    "signData": {
        "signData": "患者于⼊院前6年，⽆明显诱因出现头昏，为持续性头昏",
        "dataType": "STRING",
        "signAlgorithm": "SM3withSM2",
        "archivedAfterSigned": false
    },
    // "requiredAutoSign": true
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://m1.apifoxmock.com/m1/4604434-0-default/v1/open/hospital/hospitals/data-signature-records/flow?access_token=' \
--header 'X-Signit-App-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "businessInfo": {
        "customTag": "Customg20245202002",
        "doctorId": "job_test",
        "serviceType": "护理记录单",
        "departmentName": "呼吸内科",
        "patientId": "A01251622",
        "patientIdCard": "51072319960103441",
        "patientAge": "18",
        "patientName": "张三五",
        "patientSex": 0,
        "admissionNo": "0000000",
        "bedNo": "A0108"
    },
    "signData": {
        "signData": "患者于⼊院前6年，⽆明显诱因出现头昏，为持续性头昏",
        "dataType": "STRING",
        "signAlgorithm": "SM3withSM2",
        "archivedAfterSigned": false
    },
    // "requiredAutoSign": true
}'

返回响应

🟢200成功
application/json
Body
code
string 
必需
接⼝响应状态码；100100000=成功，其 他=失败
message
string 
接⼝响应消息
必需
record
object 
数据签名响应
必需
signatureInfo
object 
签名信息
必需
timeStampInfo
object 
必需
追加时间戳（中心医院未开此配置，可忽略）
signerSealInfo
object 
签署人印章信息
必需
certInfo
object 
签名使用的证书信息
必需
示例
{
    "code": "100100000",
    "message": "操作成功",
    "record": {
        "signatureInfo": {
            "signWsid": "WSID_SIGN_00000195caeab33c0ec91b27f44e0001",
            "businessWsid": "WSID_BUSI_000001935196f4700670f6f415e30001",
            "serviceType": "护理记录单",
            "signingData": "患者于⼊院前6年，⽆明显诱因出现头昏，为持续性头昏",
            "signingMetadata": {
                "hospitalDepartment": {
                    "departmentName": "呼吸内科"
                },
                "archivedAfterSigned": false,
                "dataType": "STRING",
                "appId": "1931fabdb516e66ca2f8c42691a",
                "umUserId": "a27fab399fb2beccc9ca2b99352d0c9eb829e5c03ed6b88029145ad41c7a4e81",
                "umProvider": "SIGNIT",
                "handMode": "AUTO"
            },
            "authorWsid": "WSID_EUSR_00000191db4ab4119ac6c81bc9be0001",
            "signTransform": "ENVELOPED",
            "signStatus": "SIGNED",
            "signStatusDescription": "已签名",
            "signStoreMethod": "DB",
            "signHashAlgorithm": "SM3",
            "signAlgorithm": "SM3withSM2",
            "signValue": "MEUCIQDJR1LZOfojokaAlOSo540hi+QEf/GhL2hqmy/ZY8oQbQIgGOxu5v27F/8OFA6WLorgXVqAn0SO0Rf2dhBeXhw/ZCo=",
            "signDatetime": 1742866134073,
            "signVersion": 11,
            "signForm": "UM_SIGN",
            "signCert": "MIIDjDCCAzGgAwIBAgINK2bgE6nOjZN0Wp2InTAMBggqgRzPVQGDdQUAMGcxCzAJBgNVBAYTAkNOMQ0wCwYDVQQKDARCSkNBMTMwMQYDVQQLDCrnrb7lj5HmtYvor5Xor4HkuabkuI3og73nlKjkuo7nlJ/kuqfkuJrliqExFDASBgNVBAMMC1NNMua1i+ivlUNBMB4XDTI0MDkxMDA4Mzg0OVoXDTI5MDkxMDA5Mzg0OVowcDELMAkGA1UEBhMCQ04xUDBOBgoJkiaJk/IsZAEBDEBhMjdmYWIzOTlmYjJiZWNjYzljYTJiOTkzNTJkMGM5ZWI4MjllNWMwM2VkNmI4ODAyOTE0NWFkNDFjN2E0ZTgxMQ8wDQYDVQQDDAblkLTmtpswWTATBgcqhkjOPQIBBggqgRzPVQGCLQNCAASheS2pWX2Sql1TfwlMh8iAICXH6y1xrKDKlHjT07BWkhDhyjRGAiiTJVs5TWz+BfkqquImDovR+/eyUfPPVE4Oo4IBtTCCAbEwDgYDVR0PAQH/BAQDAgbAMAkGA1UdEwQCMAAwEwYDVR0lBAwwCgYIKwYBBQUHAwMwgYUGA1UdHwR+MHwwQqBAoD6GPGh0dHA6Ly9jcmwuYmpjYS5vcmcuY24vY3JsL1NNMllTWFNFQ09ORENBL1NNMllTWFNFQ09ORENBLmNybDA2oDSgMoYwaHR0cDovL2NybC5iamNhLm9yZy5jbi9jcmwvU00yWVNYU0VDT05EQ0EvMzAuY3JsMB0GA1UdDgQWBBSr7vWgJd1QAWJvJwHhn/k/wq7zYjAfBgNVHSMEGDAWgBTd+maMOflgxa0plILgmad+flo67jA9BgNVHSAENjA0MDIGCSqBHIbvMgICAzAlMCMGCCsGAQUFBwIBFhdodHRwczovL3d3dy5iamNhLmNuL0NQUzB4BggrBgEFBQcBAQRsMGowOgYIKwYBBQUHMAKGLmh0dHA6Ly9yZXBvLmJqY2EuY24vbmF0aW9uYWwvY2VydC9TTTJZU1hDQS5jZXIwLAYIKwYBBQUHMAGGIGh0dHA6Ly8xOTIuMTY4LjExMi4xMDQ6ODI4MC9vY3NwMAwGCCqBHM9VAYN1BQADRwAwRAIgV7Z98LeVIEfVT2YGSgMj20H4rs112jr8QngzIONWbcUCICXeTLuZcBoBRcQbXOTHbu/Vd3RA87MS1/pAfdBJMSbR",
            "signCertSerialNumber": "2b66e013a9ce8d93745a9d889d",
            "customTag": "Customg20245202002",
            "createdDatetime": 1742866133821,
            "modifiedDatetime": 1742866133821,
            "appendTimestamp": 1,
            "dataType": "STRING"
        },
        "timeStampInfo": {
            "timestamp": 1705651800000,
            "verified": true,
            "verifiedReason": "验证成功",
            "signature": "YpZ+m6gfWefCpbUfbWYwqQ4t7kFgMykgIUl6QPQuLH6/Pi+jjC21wF6ivOP5omotRIDaBoG2PbPlJYsJs57j3Qw1VeQPf6b70QHYY6ixaOc47iNA5p76RRLBBttWIARZpc5ENEJFaBGT/9GXEQO7GP/y2u1IFkQlTA0dj8H00i7xbjQmkulYpjPfPoUZtPyhZ9Os8QQraxeBjZrN+aw0yijpOaa+naPihRiJP2hN8OR0zRuxrDbGr/paRdgYzq3A+2HvrmEHp1MgN7WYFxa4cmMDankxDgsYYeLlLqS8Xw2lFVYKYl7ZwAek4Re4BWa5HmDUaAUy1jskPr7fxNZnrA==",
            "signValue": "MIAGCSqGSIb3DQEHAqCAMIIQtgIBAzENMAsGCWCGSAFlAwQCATCBkwYLKoZIhvcNAQkQAQSggYMEgYAwfgIBAQYBKjAxMA0GCWCGSAFlAwQCAQUABCCDFsUNjl8+1sqT2Bp7KEvH3amV07gh0c7ZyR3SPxYf3QIqV1NJRF9USU1FXzAwMDAwMTk1Y2FlYWI0NGI2YTE3NjdkY2RkODg4NTUxGA8yMDI0MDExOTA4MTAwMFoCBgGVyuq0RKCCDX8wggQlMIIDDaADAgECAiRDQTIwMTUtMDQtMTZqYXZhLnV0aWwuUmFuZG9tQDFiZmQ0M2YwDQYJKoZIhvcNAQEFBQAwgYoxHTAbBgNVBAMMFFNpZ25pdCBUcnVzdCBOZXRXb3JrMRgwFgYDVQQLDA9TZWN1cml0eSBDZW50ZXIxHjAcBgNVBAoMFVNpZ25pdC5jbiBDb3Jwb3JhdGlvbjEQMA4GA1UEBwwHQ2hlbmdkdTEQMA4GA1UECAwHU2ljaHVhbjELMAkGA1UEBhMCQ04wHhcNMTUwNDE2MDEyMjEyWhcNNDUwNDE2MDEyMjEyWjCBijEdMBsGA1UEAwwUU2lnbml0IFRydXN0IE5ldFdvcmsxGDAWBgNVBAsMD1NlY3VyaXR5IENlbnRlcjEeMBwGA1UECgwVU2lnbml0LmNuIENvcnBvcmF0aW9uMRAwDgYDVQQHDAdDaGVuZ2R1MRAwDgYDVQQIDAdTaWNodWFuMQswCQYDVQQGEwJDTjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAJTIr785/zazD0KhKWKtvP8KYCk2XdSxQCo0uFU2Q60ix+wrdS3DYqZCl6S2FjvPMnqvX3wMxb8g0F0VNs7SCACham0CsRhiHFM+unOUqhP8KPFEMmioO4tCfq5FgpB/+XX5And8jWiuFzrFy4cGK2mK7003oovdGcBJBvZuJS4HC/LJanS2WX9PDnpYBrhCwVZc9zlcEjJlWPrBOCg5z3TtU0b5mMQolOhrlRAi+Fty+JA2V8R7Fw8+dCvEpKSemsR/okarxwJmZ+S2IYI2xD/Q0rGEK1Ww5e0h6vMBgSVGL0bPm6bIwZHgVSGjifZAmCjayvdCkmWucSUxau2H0ecCAwEAAaNxMG8wDwYDVR0TBAgwBgEB/wIBAzALBgNVHQ8EBAMCAY4wDwYDVR0lBAgwBgYEVR0lADAdBgNVHQ4EFgQUVEF3lbFXH4MqrEmmoP6MSMyyo9gwHwYDVR0jBBgwFoAUVEF3lbFXH4MqrEmmoP6MSMyyo9gwDQYJKoZIhvcNAQEFBQADggEBAH5GROUeXf9b0+WbDLpcRScVQBFdzP+nwaY1PCJYoG1EBiik7geWCPmGyL1kdF5g3Xi/hhl2052BlVnUCsff8tCyxEd7jZDB0zzvhsquFmULuzh5Olq4oUeWZu6QM6Q9mkuQCJkeYAg+d1cotixb/u44amnNllGKqJZR2O8DWPbzfvy+eUjrtWeb5gRYG/o+MrqLXhU6DU5jN8CeGugxoPcv0r0AaPRtdV/OLqXJilxLYK5XfgfQebAqmsU3rthwWYOqh5pKRS
🟠400参数不正确
修改于 2025-04-11 02:03:53
上一页
1.3 扫码登录回调
下一页
2.2 数据签名回传_主动查询
Built with