契约锁 API

印章管理-创建图片印章

POST

/v2/seal/createbyimage

调用此接口可上传企业印章扫描件创建企业印章，印章需契约锁客服人员审核通过才可使用，审核结果可登陆契约锁云平台查看或通过设置回调地址获取。

请求参数

Header 参数

x-qys-open-accesstoken

string

可选

默认值:

x-qys-open-timestamp

string

可选

默认值:

x-qys-open-nonce

string

可选

默认值:

x-qys-open-signature

string

可选

默认值:

Body 参数application/json

sealName

string

必需

callbackUrl

string

可选

sealSpec

string

可选

sealImage

string

必需

tenantName

string

可选

sealType

string

可选

lpLetter

string

可选

sealUsers

array[object (UserRequest) {3}]

可选

contact

string

联系方式

必需

contactType

enum<string>

联系类型

必需

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

枚举值:

MOBILEEMAILEMPLOYEEIDNUMBERBIZID

name

string

姓名

可选

示例

{
  "sealName": "string",
  "callbackUrl": "string",
  "sealSpec": "string",
  "sealImage": "string",
  "tenantName": "string",
  "sealType": "string",
  "lpLetter": "string",
  "sealUsers": [
    {
      "contact": "string",
      "contactType": "MOBILE",
      "name": "string"
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi.qiyuesuo.com/v2/seal/createbyimage' \
--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 '{
    "sealName": "string",
    "callbackUrl": "string",
    "sealSpec": "string",
    "sealImage": "string",
    "tenantName": "string",
    "sealType": "string",
    "lpLetter": "string",
    "sealUsers": [
        {
            "contact": "string",
            "contactType": "MOBILE",
            "name": "string"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

result

object

必需

applyId

string

印章申请Id

必需

示例

{
  "code": 0,
  "message": "string",
  "result": {
    "applyId": "string"
  }
}

印章管理-编辑印章

印章管理-管理印章状态