签盾开放平台-公有云版
  1. 合同查询
签盾开放平台-公有云版
  • 快速入手
    • 接入流程
    • 业务流程
  • 帮助文档
    • 基本概念
    • 合同状态说明
    • 印章指定位置
    • 静默签使用说明
    • 常见错误码
    • 回调接入文档
  • 开发前必读
    • 公共请求格式
    • 移动端(Android,IOS,微信小程序,H5)--接入
  • 认证授权
    • 用户认证&授权流程
    • 个人认证&授权
      • 获取个人认证&授权链接
      • 查询个人认证信息
      • 查询个人授权信息
    • 企业认证&授权
      • 获取企业认证&授权链接
      • 查询企业认证信息
      • 查询企业授权信息
  • 合同签署
    • 文件处理
      • 本地文件上传
        • 上传合同文件
        • 上传合同附件
      • 模版文件使用
        • 基于模板创建合同文件
      • 获取文件关键字坐标
    • 合同发起
      • 发起合同
    • 合同操作
      • 获取参与方操作链接(签署链接)
      • 催办合同签署
      • 撤回合同
    • 合同查询
      • 查询企业合同类目
        GET
      • 获取合同预览链接
        POST
      • 查询合同详情
        GET
      • 分页查询合同列表
        POST
      • 查询合同存证信息
        GET
      • 下载合同文件及合同附件
        GET
  • 审批管理
    • 审批流程使用场景
    • 列表查询用户可用的审批流程
      GET
    • 分页查询审批状态合同列表
      POST
    • 查询签署用印审批详情
      GET
    • 查询发起合同审批详情
      GET
    • 获取审批操作链接
      POST
  • 企业管理
    • 企业信息查询
    • 分页查询员工
    • 新增员工
    • 删除员工
  • 印章管理
    • 分页查询个人印章列表
    • 分页查询企业印章列表
    • 查询个人印章详情
    • 查询企业印章详情
    • 获取印章静默签授权链接
  • 回调通知
    • 回调接入文档
    • 接口测试
    • 获取回调信息
    • 回调成功确认
    • 回调成功确认(新)
  • 开放接口
    • 企业四要素校验
    • 企业三要素校验
    • 身份证OCR识别
    • 营业执照OCR识别
    • 身份二要素校验
    • 银行卡二要素
    • 银行卡三要素
    • 银行卡四要素
    • 个人二要素诉讼信息
    • 个人运营商三要素
    • 企业工商四要素
  1. 合同查询

分页查询合同列表

POST
/api/contract/page
v1.2.0V1.4.0
需要权限:
get_psn_sign_task_info:授权允许获取个人用户的签署任务
或
get_corp_sign_task_info: 授权允许获取企业的签署任务

请求参数

Body 参数application/json
openPsnId
string 
查询个人openPsnId ,与 openCorpId 二选一。此人必须是合同参与人
可选
openPsnId 和 corpInfo二选一
corpInfo
object 
查询企业openCorpId ,与 openPsnId 二选一。此人必须是合同参与人
可选
openPsnId 和 corpInfo二选一
openCorpId
string 
企业open id
必需
选择corpInfo则此项必填
staffId
string 
操作人员工ID
必需
选择corpInfo则此项必填 api1.4.0新增获取方法见:企业管理->【员工列表】
operatorPsnId
string  | null 
处理人id
已废弃
api1.4.0删除
pageSize
string 
每页显示的数量,最大值:20
可选
pageNum
string 
查询页码
可选
statusList
array[string] | null 
合同状态
可选
startTimeFrom
string  | null 
开始时间
可选
(合同创建时间)Unix时间戳(毫秒级)格式
startTimeTo
string  | null 
结束时间
可选
(合同创建时间)Unix时间戳(毫秒级)格式 【注】开始时间到结束时间的时间范围最长不可超过90天
initiator
string  | null 
发起人名
可选
signer
string  | null 
签署人名
可选
示例
{
    "openPsnId": "string",
    "corpInfo": {
        "openCorpId": "string",
        "staffId": "string",
        "operatorPsnId": "string"
    },
    "pageSize": "string",
    "pageNum": "string",
    "statusList": [
        "string"
    ],
    "startTimeFrom": "string",
    "startTimeTo": "string",
    "initiator": "string",
    "signer": "string"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://api.pre-qiandun365.com/api/contract/page' \
--header 'Content-Type: application/json' \
--data-raw '{
    "openPsnId": "string",
    "corpInfo": {
        "openCorpId": "string",
        "staffId": "string",
        "operatorPsnId": "string"
    },
    "pageSize": "string",
    "pageNum": "string",
    "statusList": [
        "string"
    ],
    "startTimeFrom": "string",
    "startTimeTo": "string",
    "initiator": "string",
    "signer": "string"
}'

返回响应

🟢200成功
application/json
Body
code
string 
业务编码
必需
msg
string 
业务信息
必需
result
object  | null 
业务数据
必需
data
array [object {11}] 
必需
totalCount
integer 
数量总和
可选
success
boolean 
是否成功
可选
ts
string 
时间戳
必需
logKey
string 
日志key
必需
示例
{
    "code": "200",
    "msg": "成功",
    "result": {
        "data": [
            {
                "contractId": 12323,
                "contractName": "电子签章授权书",
                "contractNo": "CM_20230517144140SwCHesRkBTjRjcE",
                "contractStatus": "finished",
                "seqSigning": true,
                "signers": [
                    {
                        "seqNo": 1,
                        "psnSignerInfo": {
                            "receiverName": "张三",
                            "receiverPhone": "13322221111"
                        },
                        "corpSignerInfo": null,
                        "status": "finished"
                    },
                    {
                        "seqNo": 2,
                        "psnSignerInfo": null,
                        "corpSignerInfo": {
                            "corpName": "浙江签盾科技有限公司",
                            "receiverName": "张三",
                            "receiverPhone": "13322221111"
                        },
                        "status": "finished"
                    }
                ],
                "startTime": "2023-01-01",
                "endTime": "2023-12-30",
                "finishedTime": "2023-05-17",
                "signDeadline": "2023-12-17"
            }
        ],
        "totalCount": 1
    },
    "success": true
}
上一页
查询合同详情
下一页
查询合同存证信息
Built with