接入凭证
调用开放平台接口前,需要先获得接入凭证。apiKey 不能自助申请,请联系我们为企业开通开放应用。
开通后,签签会为你的企业分配并告知以下信息:
| 配置项 | 用途 | 说明 |
|---|---|---|
接口基址 {baseUrl} | 调用 HTTPS 接口 | 测试与生产环境地址可能不同,以开通时告知为准 |
apiKey | 调用接口鉴权 | 一把 key 对应一个企业 |
| 回调地址 | 接收状态通知 | 须为 HTTPS,由你方提供、开通时登记 |
| 回调密钥 | 校验回调签名 | 仅用于验签,不参与接口调用 |
如何获取
- 联系签签商务或技术支持,申请开通开放平台能力。
- 提供企业信息,以及用于接收回调的 HTTPS 地址。
- 开通完成后,你将收到
apiKey、接口基址与回调密钥;请妥善保管,勿提交到代码仓库或泄露给无关人员。
如需更换回调地址、重置密钥或停用 apiKey,同样请联系我们处理。
权限范围
一把 apiKey 只能访问:
- 该企业已启用的模板
- 由该 key 创建的合同
无法访问其他企业的数据。请求中的发起人已绑定在该 key 上,无需在报文中额外传递。
如何使用
每个请求(含下载合同文件)均须在请求头携带:
http
X-Api-Key: sk_live_example示例中的值为虚构数据,请替换为开通时分配给你的真实 apiKey。
apiKey 无效或已停用时,接口返回 HTTP 401、code 为 40100。详见错误码查询。