契约锁 API

授权管理-取消个人签名授权

POST

/v2/personalsign/deauthorize

调用此接口取消生效中的个人签名签署授权。

请求参数

Header 参数

x-qys-open-accesstoken

string

可选

默认值:

x-qys-open-timestamp

string

可选

默认值:

x-qys-open-nonce

string

可选

默认值:

x-qys-open-signature

string

可选

默认值:

Body 参数application/json

user

object

授权用户

必需

contact

string

联系方式

必需

contactType

enum<string>

联系类型

必需

MOBILE（手机号），EMAIL（邮箱），EMPLOYEEID（员工ID），NUMBER（员工编号），BIZID（用户在对接方系统的唯一标识）

枚举值:

MOBILEEMAILEMPLOYEEIDNUMBERBIZID

tenantName

string

子公司名称

可选

若授权给子公司，则需要传递该值，用于确定授权主体

示例

{
  "user": {
    "contact": "15021504325",
    "contactType": "MOBILE"
  },
  "company": "上海契约锁电子合同签名有限公司"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi.qiyuesuo.com/v2/personalsign/deauthorize' \
--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

必需

示例

{
  "code": 0,
  "message": "SUCCESS"
}

授权管理-个人签名授权页面

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