7.1 Webhook回调接口：数据签名示例

POST

https://yourdomain.com/webhook/datasignature-callback

接⼝地址：由调⽤⽅提供，比如 https://yourdomain.com/webhook/datasignature-callback
接⼝类型：POST
参数位置：Body
接⼝描述：接收签名系统回传的⽂件签名结果
说明：回调接⼝不⽀持传递鉴权参数和额外的Header参数

请求参数

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

event

string

事件名称

必需

eventDescription

string

事件描述

必需

target

object

本事件接收的地址

必需

destination

string

必需

rawData

string

本事件接收的消息内容

必需

needCallBack

boolean

本事件是否需要回调

必需

示例

{
"event":"dataSignatureCompleted",
"eventDescription":"数据签名完成",
"target":{
"destination":"https://webhook.site/5c601c31-1ffa-4750-8872-cb69257d7af5"
},
"rawData":"{\"business\":{\"patientId\":\"AA12345678\",\"patientName \":\"李某某\",\"admissionNumber\":null,\"idCard\":null,\"serviceType\":\"D_ ⻄药处⽅\",\"departmentName\":\"ceshike\",\"departmentId\":null,\"doctorName \":\"签名医⽣\",\"doctorId\":\"lidd\",\"serviceId\":\"L20240512203223\"},\"s ignature\":{\"signWsid\":\"WSID_SIGN_0000018f6cca445c0242196331aa0001 \",\"businessWsid\":\"WSID_BUSI_0000018f6cca420a0242196331aa0001\",\"signi ngData\":\"这是待签原⽂\",\"authorWsid\":\"WSID_EUSR_0000018eccb6b8caf889d29 c4a420001\",\"signStatus\":\"SIGNED\",\"signValue\":\"MEUCIBZSKnAuf9GLt29x CXvxbxG2C4O4GEy1xuRyp+CZTeapAiEAtcLiiYg80gxhiovIl5JjMwL8FTB3qsqIljGcqgSJmQ Y=\",\"signDatetime\":1715517253000,\"signStatusReason\":null,\"appendTime stamp\":1},\"appInfo\":{\"appId\":\"1840e3e1b03ba689b193fa5acc2\",\"appNam e\":\"标准签署应⽤\"}}",
"needCallBack":false
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://yourdomain.com/webhook/datasignature-callback?access_token=' \
--header 'X-Signit-App-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
"event":"dataSignatureCompleted",
"eventDescription":"数据签名完成",
"target":{
"destination":"https://webhook.site/5c601c31-1ffa-4750-8872-cb69257d7af5"
},
"rawData":"{\"business\":{\"patientId\":\"AA12345678\",\"patientName \":\"李某某\",\"admissionNumber\":null,\"idCard\":null,\"serviceType\":\"D_ ⻄药处⽅\",\"departmentName\":\"ceshike\",\"departmentId\":null,\"doctorName \":\"签名医⽣\",\"doctorId\":\"lidd\",\"serviceId\":\"L20240512203223\"},\"s ignature\":{\"signWsid\":\"WSID_SIGN_0000018f6cca445c0242196331aa0001 \",\"businessWsid\":\"WSID_BUSI_0000018f6cca420a0242196331aa0001\",\"signi ngData\":\"这是待签原⽂\",\"authorWsid\":\"WSID_EUSR_0000018eccb6b8caf889d29 c4a420001\",\"signStatus\":\"SIGNED\",\"signValue\":\"MEUCIBZSKnAuf9GLt29x CXvxbxG2C4O4GEy1xuRyp+CZTeapAiEAtcLiiYg80gxhiovIl5JjMwL8FTB3qsqIljGcqgSJmQ Y=\",\"signDatetime\":1715517253000,\"signStatusReason\":null,\"appendTime stamp\":1},\"appInfo\":{\"appId\":\"1840e3e1b03ba689b193fa5acc2\",\"appNam e\":\"标准签署应⽤\"}}",
"needCallBack":false
}'

返回响应

🟢200成功

application/json

Body

code

string

状态码

必需

description

string

说明

必需

描述

示例

{
    "code": "0",
    "description": "接收成功"
}

🟠400参数不正确

修改于 2025-02-17 09:31:53

WebHook回调接口文档说明

7.2 Webhook回调接口：文件签名回调示例