跳到主要内容
版本：v2.0

重新获取合同签名

获取订单 返回的 sign_pdf_url（电子合同链接）在私有域名加签成功时为有效期 7 天的临时签名链接，过期后可通过本接口按订单 ID 重新获取，无需重新构造其它查询条件。

POST/api/getOrderSignUrl

请求参数​

名称类型描述是否必填默认值备注
tokenString身份校验令牌必填-由 获取访问令牌 获得
order_idNumber订单 ID必填-由 获取订单 返回

CURL​

V1​

curl --location --request POST 'https://open.xinduobang.cn/api/getOrderSignUrl' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'token=YOUR_TOKEN' \
--data-urlencode 'order_id=1111'

V2（appid 为 V2 版本）​

curl --location --request POST 'https://open.xinduobang.cn/api/getOrderSignUrl' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'X-Timestamp: 1770000000' \
--header 'X-Nonce: 3f9c1a7b2e6d4058' \
--header 'X-Signature: <computed_hmac_sha256>' \
--data-urlencode 'token=YOUR_TOKEN' \
--data-urlencode 'order_id=1111'

成功响应​

{
  "code": 0,
  "msg": "success",
  "data": {
    "order_id": 1111,
    "sign_pdf_title": "测试电子签章",
    "sign_pdf_url": "https://priv.xdbcdn.cn/signature/demo/20260908115156342589177199.pdf?x-oss-signature=xxxx&x-oss-expires=604800&x-oss-credential=xxxx&x-oss-signature-version=OSS4-HMAC-SHA256"
  }
}

响应字段​

字段类型说明
order_idNumber订单 ID
sign_pdf_titleString电子合同名称；订单无合同时为空字符串
sign_pdf_urlString电子合同地址；私有域名加签成功时有效期 7 天，其他地址或加签失败时可能返回原地址；无合同时为空字符串
信息
  • 链接带有一长串 x-oss-* 签名参数属正常现象，使用时请勿截断或拼接；
  • code=0 表示订单查询成功，不保证合同地址一定非空或已成功加签；打不开时重新获取，仍失败再反馈具体错误。
  • 获取后请尽快使用（如即时查看/下载），请勿缓存或落库。

失败响应​

HTTP状态码错误码描述排查建议
2004001缺少必要参数order_id请检查请求参数是否包含 order_id
2004001该订单不存在请确认 order_id 是否正确、是否属于当前账号

相关接口​