契约锁 API
  1. 授权管理
契约锁 API
  • 平台简介
    • 平台简介
  • 新手指南
    • 接入流程
    • 名称解释
    • 接入示例
  • API协议
    • API协议
  • API文档
    • 合同管理
      • 合同管理-创建合同草稿
      • 合同管理-用文件添加合同文档
      • 合同管理-多文件添加合同文档
      • 合同管理-用模板添加合同文档
      • 合同管理-发起合同
      • 合同管理-抄送合同
      • 合同管理-修改签署方
      • 合同管理-添加签署方
      • 合同管理-浏览页面
      • 合同管理-合同详情
      • 合同管理-获取合同列表
      • 合同管理-下载合同与附属文件
      • 合同管理-下载合同文档
      • 合同管理-强制结束合同
      • 合同管理-上传强制结束附件
      • 合同管理-合同文档添加水印
      • 合同管理-合同延期
      • 合同管理-获取合同操作记录
      • 合同管理-获取合同与附属文件下载链接
    • 签署服务
      • 签署服务-公章签署
      • 签署服务-签署法人章
      • 签署服务-审批
      • 签署服务-合同催签
      • 签署服务-签署页面
      • 签署服务-预签署页面
      • 签署服务-获取短链接
      • 签署服务-撤回/作废合同
      • 签署服务-自定义文件作废合同
      • 签署服务-自定义模板文件作废合同
      • 签署服务-签署作废合同
      • 签署服务-签署个人签名
    • 组织架构
      • 组织架构-子公司列表
      • 组织架构-发送子公司邀请
      • 组织架构-移除子公司
      • 组织架构-对接方信息
      • 组织架构-公司详情
      • 组织架构-获取企业信息变更链接
      • 组织架构-员工列表
      • 组织架构-添加员工
      • 组织架构-更新员工
      • 组织架构-员工详情
      • 组织架构-管理员工角色
      • 组织架构-移除员工
    • 印章管理
      • 印章管理-印章列表
      • 印章管理-印章图片
      • 印章管理-创建印章
      • 印章管理-印章详情
      • 印章管理-编辑印章
      • 印章管理-创建图片印章
      • 印章管理-管理印章状态
      • 印章管理-删除印章
      • 印章管理-公司印章
    • 模板管理
      • 模板管理-模板列表
      • 模板管理-模板详情
      • 模板管理-模版预览页面
      • 模板管理-创建Word模板
      • 模板管理-编辑模板
      • 模板管理-管理模板状态
      • 模板管理-下载模板
      • 模板管理-删除模板
    • 业务分类
      • 业务分类-业务分类列表
      • 业务分类-业务分类详情
    • 个人认证
      • 个人认证-获取个人认证链接
      • 个人认证-查询个人认证状态
    • 企业认证
      • 企业认证-获取企业认证链接PC
      • 企业认证-获取企业认证链接H5
      • 企业认证-获取企业认证链接-带营业执照PC
      • 企业认证-获取企业认证链接-带营业执照H5
      • 企业认证-查询认证结果
    • 外部客户
      • 外部客户-新增外部客户
    • 授权管理
      • 授权管理-单点登录模块授权页面
        POST
      • 授权管理-个人签名授权页面
        POST
      • 授权管理-取消个人签名授权
        POST
      • 授权管理-查询个人静默签授权记录
        POST
    • 辅助工具
      • 辅助工具-文件验签
    • 信息校验
      • 信息校验-个人身份校验
      • 信息校验-企业身份校验
  • 单点登录集成
    • 集成流程说明
    • 单点登录
    • 单点登出
    • CAS验证接口规范
  • JS SDK文档
    • JS SDK简介
    • 集成方式说明
    • 对接方服务端接口说明
  • 公告
    • 关于开发平台控制台的说明
  • 小程序插件
    • 插件简介
    • 插件集成说明
    • 生成合同签署令牌
    • 生成个人认证令牌
    • 生成企业认证令牌
    • 生成企业认证令牌(带营业执照)
    • 插件更新记录
  • 常见问题
    • 认证问题
    • 配置问题
    • 接口问题
    • 其他问题
  1. 授权管理

授权管理-查询个人静默签授权记录

POST
/v2/personalsign/query

请求参数

Header 参数
x-qys-open-accesstoken
string 
可选
默认值:
{{x-qys-open-accesstoken}}
x-qys-open-timestamp
string 
可选
默认值:
{{x-qys-open-timestamp}}
x-qys-open-nonce
string 
可选
默认值:
{{x-qys-open-nonce}}
x-qys-open-signature
string 
可选
默认值:
{{x-qys-open-signature}}
Body 参数application/json
user
object 
必需
contact
string 
联系方式
必需
contactType
enum<string> 
联系类型
必需
MOBILE(手机号),EMAIL(邮箱),EMPLOYEEID(员工ID),NUMBER(员工编号),BIZID(用户在对接方系统的唯一标识)
枚举值:
MOBILEEMAILEMPLOYEEIDNUMBERBIZID
authStatus
enum<string> 
可选
默认不传,不传则返回授权 给该业务系统的所有静默签 授权记录。也可以传入某个 指定的静默签授权状态,则 接口仅返回传入的状态的所 有静默签授权记录,可传入 的状态有生效中、已过期、 已取消
枚举值:
authorizedexpireddeauthorized
示例
{
  "user": {
    "contact": "15021504325",
    "contactType": "MOBILE"
  },
  "company": "上海契约锁电子合同签名有限公司"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://openapi.qiyuesuo.com/v2/personalsign/query' \
--header 'x-qys-open-accesstoken: {{x-qys-open-accesstoken}}' \
--header 'x-qys-open-timestamp: {{x-qys-open-timestamp}}' \
--header 'x-qys-open-nonce: {{x-qys-open-nonce}}' \
--header 'x-qys-open-signature: {{x-qys-open-signature}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "user":{
        "contact":"15021504325",
        "contactType":"MOBILE"
    },
    "company":"上海契约锁电子合同签名有限公司"
}'

返回响应

🟢200成功
application/json
Body
code
integer 
必需
message
string 
必需
result
array[object (PersonalAuthAutoSignResponse) {15}] 
必需
agentId
string 
服务商id
必需
tokenId
string 
业务系统id
必需
appName
string 
业务系统名称
必需
companyId
string 
企业Id
必需
companyName
string 
企业名称
必需
userId
string 
授权用户id
必需
remark
string 
授权理由
可选
authMethod
string 
授权方式
可选
authStatus
enum<string> 
授权状态
可选
枚举值:
authorizedexpired deauthorized
authDeadline
string 
授权截止时间
可选
createTime
string 
创建时间
可选
updateTime
string 
更新时间
可选
callbackUrl
string 
回调地址
可选
isDelete
boolean 
是否删除
可选
authInfo
string 
指定认证信息
可选
示例
{
  "result": [
    {
      "id": "3025382284275617834",
      "agentId": "10000",
      "tokenId": "2667951614759215723",
      "appName": "邓茜茜测试应用(勿动)",
      "companyId": "2375616490882524008",
      "companyName": "思晨教育",
      "userId": "2271136400600465408",
      "remark": "auth 54",
      "authStatus": "unauthorized",
      "authDeadline": "2023-06-15 23:59:59",
      "createTime": "2022-11-02 19:09:05",
      "updateTime": "2022-11-02 19:09:05",
      "callbackUrl": "http://cloud.qiyuesuo.me",
      "allowPersonalAuto": true,
      "delete": false
    },
    {
      "id": "3025382395852492844",
      "agentId": "10000",
      "tokenId": "2667951614759215723",
      "appName": "邓茜茜测试应用(勿动)",
      "companyId": "2375616490882524008",
      "companyName": "思晨教育",
      "userId": "2271136400600465408",
      "remark": "auth 54",
      "authMethod": "FACE",
      "authStatus": "deauthorized",
      "authDeadline": "2023-06-15 23:59:59",
      "createTime": "2022-11-02 19:09:32",
      "updateTime": "2023-01-06 17:05:49",
      "callbackUrl": "http://cloud.qiyuesuo.me",
      "allowPersonalAuto": true,
      "delete": false
    }
  ],
  "code": 0,
  "message": "SUCCESS"
}
上一页
授权管理-取消个人签名授权
下一页
辅助工具-文件验签
Built with