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

分页查询审批状态合同列表

POST
/api/pageInstanceApproval
V1.2.2
查询合同审批信息,同一个合同可能会有多条审批记录
需要权限:
get_corp_ident_info: 授权允许获取企业信息

请求参数

Body 参数application/json
openCorpId
string 
企业ID
必需
approvalType
string  | null 
审批类型,如不传则查询全部类型: contract_start:发起审批 seal_apply:用印审批
可选
approvalStatus
string  | null 
审批状态:如不传则查询全部状态 wait_audit:待审 passed:通过 rejected:拒绝 termination:审批终止(合同撤回,审批撤回等情况)
可选
startTimeFrom
string  | null 
审批发起时间最早 格式:yyyy-MM-dd HH:mm:ss
可选
startTimeTo
string  | null 
审批发起时间最晚 格式:yyyy-MM-dd HH:mm:ss
可选
pageNum
string 
分页页数,如果不传默认返回第一页
必需
pageSize
string 
分页行数,如果不传默认为20
必需
示例
{
  "openCorpId": "1713823122383572992",
  "pageNum": "1",
  "pageSize": "20"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'api.pre-qiandun365.com/api/pageInstanceApproval' \
--header 'Content-Type: application/json' \
--data-raw '{
    "openCorpId": "1713823122383572992",
    "pageNum": "1",
    "pageSize": "20"
}'

返回响应

🟢200成功
application/json
Body
code
string 
请求code
必需
msg
string 
请求消息
必需
success
boolean 
是否成功
必需
logKey
string 
必需
ts
string 
必需
result
object 
必需
data
array [object {12}]  | null 
审批列表信息
必需
totalCount
integer 
审批流程总数
必需
查询到的审批流程总数
示例
{
  "result": {
    "totalCount": 8,
    "data": [
      {
        "instanceApprovalId": "1621",
        "approvalId": "224",
        "approvalName": "发起审批",
        "approvalType": "contract_start",
        "approvalStatus": "passed",
        "contractId": "7935",
        "contractName": "《签盾员工入职合同》",
        "approvalStartTime": "2024-03-26 16:48:20",
        "signDeadline": "2025-01-01 23:59:59",
        "nodeCount": 2,
        "currentNode": 2,
        "revoked": false
      },
      {
        "instanceApprovalId": "1620",
        "approvalId": "224",
        "approvalName": "发起审批",
        "approvalType": "contract_start",
        "approvalStatus": "wait_audit",
        "contractId": "7932",
        "contractName": "《签盾员工入职合同》",
        "approvalStartTime": "2024-03-26 15:54:04",
        "signDeadline": "2025-01-01 23:59:59",
        "nodeCount": 2,
        "currentNode": 0,
        "revoked": false
      },
      {
        "instanceApprovalId": "1619",
        "approvalId": "224",
        "approvalName": "发起审批",
        "approvalType": "contract_start",
        "approvalStatus": "wait_audit",
        "contractId": "7931",
        "contractName": "《签盾员工入职合同》",
        "approvalStartTime": "2024-03-26 15:51:23",
        "signDeadline": "2025-01-01 23:59:59",
        "nodeCount": 2,
        "currentNode": 0,
        "revoked": false
      },
      {
        "instanceApprovalId": "1606",
        "approvalId": "224",
        "approvalName": "发起审批",
        "approvalType": "contract_start",
        "approvalStatus": "passed",
        "contractId": "7905",
        "contractName": "《签盾员工入职合同》",
        "approvalStartTime": "2024-03-26 14:34:24",
        "signDeadline": "2025-01-01 23:59:59",
        "nodeCount": 2,
        "currentNode": 2,
        "revoked": false
      },
      {
        "instanceApprovalId": "1605",
        "approvalId": "224",
        "approvalName": "发起审批",
        "approvalType": "contract_start",
        "approvalStatus": "wait_audit",
        "contractId": "7904",
        "contractName": "《签盾员工入职合同》",
        "approvalStartTime": "2024-03-26 14:27:21",
        "signDeadline": "2025-01-01 23:59:59",
        "nodeCount": 2,
        "currentNode": 0,
        "revoked": false
      },
      {
        "instanceApprovalId": "604",
        "approvalId": "224",
        "approvalName": "发起审批",
        "approvalType": "contract_start",
        "approvalStatus": "wait_audit",
        "contractId": "5742",
        "contractName": "API-测试",
        "approvalStartTime": "2023-10-17 15:04:05",
        "signDeadline": "2024-01-01 23:59:59",
        "nodeCount": 2,
        "currentNode": 0,
        "revoked": false
      },
      {
        "instanceApprovalId": "603",
        "approvalId": "224",
        "approvalName": "发起审批",
        "approvalType": "contract_start",
        "approvalStatus": "passed",
        "contractId": "5741",
        "contractName": "API-测试",
        "approvalStartTime": "2023-10-17 13:53:14",
        "signDeadline": "2024-01-01 23:59:59",
        "nodeCount": 2,
        "currentNode": 2,
        "revoked": false
      },
      {
        "instanceApprovalId": "602",
        "approvalId": "224",
        "approvalName": "发起审批",
        "approvalType": "contract_start",
        "approvalStatus": "passed",
        "contractId": "5740",
        "contractName": "API-测试",
        "approvalStartTime": "2023-10-17 13:49:58",
        "signDeadline": "2024-01-01 23:59:59",
        "nodeCount": 2,
        "currentNode": 2,
        "revoked": false
      }
    ]
  },
  "code": "200",
  "msg": "成功",
  "logKey": "93648d5c",
  "ts": "1711444617521",
  "success": true
}
修改于 2024-03-26 09:18:11
上一页
列表查询用户可用的审批流程
下一页
查询签署用印审批详情
Built with