生成单据签名
- 接口:common/document/signature
- Method:POST
- 数据格式:JSON
- 接口说明:
user_name
和employee_number
必填其一
expire_time
为失效时间(和当前时间相差不能超过7天), 不传默认为当前时间+2小时
请求参数
字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度 |
bizId |
String |
当前接口同步的唯一标识 |
TRUE |
36 |
timestamp |
Long |
当前接口同步的对应时间戳 |
TRUE |
13 |
data |
Object |
请求数据 |
TRUE |
/ |
data.external_id |
String |
外部系统单据号或云简单据号 |
TRUE |
64 |
data.user_name |
String |
用户名 |
ONE-OF 2 |
64 |
data.employee_number |
String |
员工号 |
ONE-OF 2 |
64 |
data.expire_time |
Long |
失效时间时间戳 |
FALSE |
13 |
请求数据
{
"bizId": "e7bfb2f4-c9f0-4c86-acfb-10ab2febed29",
"timestamp": 1683648000000,
"data": {
"external_id": "EXP0000000001",
"employee_number": "test@test.com",
"expire_time": 1683820800000
}
}
返回参数
字段名称 |
字段类型 |
字段描述 |
resCode |
Integer |
响应状态码(见附录) |
resMsg |
String |
返回信息描述 |
data |
Object |
返回信息 |
data.signature |
String |
签名 |
返回数据
{
"resCode": 200000,
"resMsg": "success",
"bizId": "e7bfb2f4-c9f0-4c86-acfb-10ab2febed29",
"data": {
"signature": "SfpJEdvt7irVFbAcKa3OZkoci9L8uRwfFhkYXsjFw2jrcURYS7I0W14keH96wB4lrzgwC3fxWDisiaXCPKZvlQ=="
}
}
{
"resCode": 400000,
"resMsg": "document_num和external_id必填其一"/"user_name和employee_number必填其一"
/"单据不存在"/"用户不存在"/"失效时间不能小于当前时间"/"失效时间和当前时间相差不能超过7天"
}