跳到主要内容

查询已签署的加入协议

此端点返回自动签署的已签署加入协议的下载链接，其中附有 QI SIGN 的签署报告。

当自动签署进入 enabled，即所有签署人均已通过签署链接完成签署后，已签署的协议即可获取。在其他任何状态下，此端点将返回 ISS0000030。

临时链接

signed_url 是一个临时链接，有效期为 24 小时。如需新链接，请再次调用此端点。

查询已签署协议 (GET)​

Request​

ENDPOINT
/issuer_management/issuer/ISSUER-KEY/auto_signature/report
MÉTODO
GET

Path Params​

字段类型描述字符数
ISSUER-KEYstring发行人的唯一键（UUID v4）。36

Response​

STATUS
200
Response Body
{
  "envelope_key": "9c3f0f1e-6a2b-4c58-9c9c-0f6b1d2a7e34",
  "status": "signed",
  "signed_file_url": null,
  "documents": [
    {
      "document_type": "adhesion_auto_signature_term",
      "signed_url": "https://qisign-dossiers.s3.amazonaws.com/7bcf5868-784a-4356-85fb-dd72fd53cd4a.pdf?X-Amz-Expires=86400&X-Amz-Signature=...",
      "signers": []
    }
  ],
  "issuer_key": "07b1ac01-5fc4-475f-930b-19595f24bc1e",
  "issuer_auto_signature_key": "9c3f0f1e-6a2b-4c58-9c9c-0f6b1d2a7e34"
}

Response Body Params​

字段类型描述
envelope_keystring加入协议签署信封的唯一键。
statusstring信封在 QI SIGN 中的状态。始终为 signed。
signed_file_urlnull自动签署中不使用。已签署协议的链接位于 documents[].signed_url。
documentsarray信封中的文件。加入协议是唯一的文件。
issuer_keystring发行人的唯一键。
issuer_auto_signature_keystring自动签署的唯一键。

documents 字段：

字段类型描述
document_typestring始终为 adhesion_auto_signature_term。
signed_urlstring已签署协议 PDF（附签署报告）的临时下载链接（24 小时）。
signersarray在此查询中始终为空。如需签署人信息，请使用签署链接查询。

错误​

HTTP代码触发条件
400ISS0000030 (AutoSignatureInWrongStatus)自动签署不处于 enabled — 加入协议尚未签署。
403ISS000011 (TenantForbidden)客户对所指定发行人的登记信息不具备完整访问权限。
404ISS000009 (IssuerNotFound)不存在与所给键对应的发行人。
404ISS0000028 (AutoSignatureNotFound)发行人没有有效的自动签署。