# 电子签章示例

# 服务场景描述

电子签章服务通过调用设置印章、上传合同、添加签署人、签署合同以及合同归档等API功能的调用,满足用户电子签章需求。如图所示:

电子签章使用流程

# 服务调用流程

# 1.本服务调用依赖以下API:

# 2.服务调用前置条件:

  • 创建应用,获取appkey、appsecret;

  • 获取服务调用token;

  • 开通服务,scope授权通过;

    以上步骤可参考前置准备

  • 实名认证 使用电子签章服务,签署人必须完成实名认证并申请数字证书操作。 以上步骤可参考实名认证

# 3.具体调用步骤

step1:设置印章

以自定义印章为例(accountId为实名认证账户ID):

# 调用自定义印章接口:
 curl -X POST "https://apigate.glodon.com/b-trust-test/api/v2/esignature/seal/" -H \
 "accept: application/json;charset=UTF-8" -H "authorization: Bearer cn-3a9e951a-14ea-452a-9768-306beb5e89d1" -H \
 "Content-Type: application/json" -d "{ \"accountId\": \"acct97713983829573632\", \"imageData\": \"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\", \
 \"remark\": \"备注\"}"

# 接口调用返回:
{
  "code": "10000",
  "data": {
    "sealId": "seal120910075962327040" //印章id
  },
  "message": "成功"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

step2:上传合同

以上传并同时创建为例:

# 调用上传并创建合同接口:
 curl -X POST "https://apigate.glodon.com/b-trust-test/api/v2/esignature/contract/uploadAndCreate?accountId=acct97713983829573632&contractTitle=XX%E5%90%88%E5%90%8C" -H \
 "accept: */*" -H "authorization: Bearer cn-3a9e951a-14ea-452a-9768-306beb5e89d1" -H \
 "Content-Type: multipart/form-data" -F "file=@ISCC_2018.pdf;type=application/pdf"

# 接口调用返回:
{
 "code":"10000",
 "data":{
   "contractId":"ctct120914438076235776" //生成的合同id
 },
 "message":"成功"
}
1
2
3
4
5
6
7
8
9
10
11
12
13

step3:添加签署人

# 调用添加签署者接口:
curl -X POST "https://apigate.glodon.com/b-trust-test/api/v2/esignature/contract/signers" -H \
 "accept: application/json;charset=UTF-8" -H "authorization: Bearer cn-3a9e951a-14ea-452a-9768-306beb5e89d1" -H \
 "Content-Type: application/json" -d "{ \"contractId\": \"ctct120914438076235776\", \"signers\": [ { \"accountId\": \"acct97713983829573632\", \"signPositionType\": 1, \
 \"positionContent\": \"1,30,49\", \"signForm\": 1 } ]}"

 # 接口调用返回:
    {
     "code":"10000",
     "data":{
         "contractId":"ctct120914438076235776",
         "signers":[
             {
                 "accountId":"acct97713983829573632",
                 "signerId":"sgnr120915537315233792" //生成的签署者id
             }
         ]
     },
     "message":"成功"
    }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

step4:启动签署

  # 调用启动合同签署流程接口:
     curl -X POST "https://apigate.glodon.com/b-trust-test/api/v2/esignature/contract/start" -H \
      "accept: application/json;charset=UTF-8" -H "authorization: Bearer cn-3a9e951a-14ea-452a-9768-306beb5e89d1" -H \
      "Content-Type: application/json" -d "{ \"contractId\": \"ctct120914438076235776\"}"

    # 接口调用返回:
     {
       "code": "10000",
       "data": null,
       "message": "成功"
     }
1
2
3
4
5
6
7
8
9
10
11

step5:签署合同 以手动签署为例:

# 调用获取手动签署地址接口:
  curl -X POST "https://apigate.glodon.com/b-trust-test/api/v2/esignature/contract/sign/url" -H \
  "accept: application/json;charset=UTF-8" -H "authorization: Bearer cn-3a9e951a-14ea-452a-9768-306beb5e89d1" -H \
  "Content-Type: application/json" -d "{ \"signerId\": \"sgnr120915537315233792\", \"sealId\": \"seal120910075962327040\", \"returnUrl\": \"http:///114.115.148.211:8900/swagger-ui.html\", \
  \"remark\": \"备注\"}"

# 接口调用返回:
 {
 	"code":"10000",
 	"data":{
 		"accountId":"acct97713983829573632",
 		"signer":"sgnr120915537315233792",
 		//生成合同手动签署url
 		"url":"http://sdktestapiserver.fadada.com:8888/sdk_server/get_sign_page?app_id=402558&timestamp=20200529160406&v=2.0&contract_id=ctct120914438076235776&customer_id=A8EFDCD0DF1B2B03F706E0F1932F54AA&person_id=&transaction_id=sgnr120915537315233792&sign_locations=%5B%7B%22pagenum%22%3A1%2C%22x%22%3A30.0%2C%22y%22%3A49.0%7D%5D&notify_url=http://114.115.216.139:8900/api/v2/esignature/contract/notify&return_url=http:///114.115.148.211:8900/swagger-ui.html&client_url=http://114.115.216.139:8900&signature_id=4730263&is_mobile=null&is_close=&get_image_by_browser=&ver_call_way=&show_signature=&sms_template=&token=&is_verify=null&verify_way=null&msg_digest=NEJCQjQ2M0NBMUM3NDBDODAxMThDMUVEQTg0QjJCNDNENDBERUYzMg=="
 	},
 	"message":"成功"
 }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

获取合同手动签署url地址后,在浏览器中打开,执行参照上面第二点手动签署页面。签署页面如下图:

页面签署

step6:签署归档

# 调用合同归档接口:
  curl -X POST "https://apigate.glodon.com/b-trust-test/api/v2/esignature/contract/evidence" -H \
  "accept: application/json;charset=UTF-8" -H "authorization: Bearer cn-3a9e951a-14ea-452a-9768-306beb5e89d1" -H \
  "Content-Type: application/json" -d "{ \"contractId\": \"ctct120914438076235776\"}"

# 接口调用返回:
 {
   "code": "10000",
   "data": {
     "czId": "czid120919064355799040" //存证id
   },
   "message": "成功"
 }
1
2
3
4
5
6
7
8
9
10
11
12
13
Last Updated: 5/27/2020, 3:10:55 AM
  • 在线客服

  • 意见反馈