契约锁 API

印章管理-创建印章

POST

/v2/seal/autocreate

调用此接口可以直接为公司生成印章，并指定印章使用者，不需要经过契约锁审核。可以在云平台中，侧边栏-》企业-》印章管理-》制作印章页面中，选择"自动生成"来查看生成效果

请求参数

Header 参数

x-qys-open-accesstoken

string

可选

默认值:

x-qys-open-timestamp

string

可选

默认值:

x-qys-open-nonce

string

可选

默认值:

x-qys-open-signature

string

可选

默认值:

Body 参数application/json

tenantName

string

可选

name

string

必需

sealImageInfo

object (SealImageInfoRequest)

必需

style

enum<string>

印章样式

必需

UNIVERSAL_SEAL（公章），SPECIAL_SEAL（专用章），YOUTH_LEAGUE_SEAL（共青团章），FOREIGN_SEAL（外资企业公章-中文），FOREIGN_MIX_SEAL（外资企业公章-中英文混合）

枚举值:

UNIVERSAL_SEALSPECIAL_SEALYOUTH_LEAGUE_SEALFOREIGN_SEALFOREIGN_MIX_SEAL

spec

string

印章形状

可选

CIRCULAR_42（圆形、直径42mm），CIRCULAR_40（圆形、直径40mm），CIRCULAR_44（圆形、直径44mm），CIRCULAR_45（圆形、直径45mm），OVAL_45_30（椭圆、长短轴45mm/30mm）

branchName

string

分公司名称

可选

用于设置分公司公章

foot

string

下方横排文字

可选

除FOREIGN_MIX_SEAL外，其他样式均可设置

enterpriseCode

string

企业信息编码

可选

为13到15位的数字，生成公章时设置

enContent

string

环排英文文字

可选

用于FOREIGN_MIX_SEAL样式的印章

edgeWidth

string

圆边宽

可选

YOUTH_LEAGUE_SEAL样式的章可设置值为1.5/1.2，此样式默认为1.2

users

array [object {2}]

必需

contact

string

联系方式

必需

contactType

enum<string>

联系类型

必需

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

枚举值:

MOBILEEMAILEMPLOYEEIDNUMBERBIZID

示例

{
  "tenantName": "string",
  "name": "string",
  "sealImageInfo": {
    "style": "UNIVERSAL_SEAL",
    "spec": "string",
    "branchName": "string",
    "foot": "string",
    "enterpriseCode": "string",
    "enContent": "string",
    "edgeWidth": "string"
  },
  "users": [
    {
      "contact": "string",
      "contactType": "MOBILE"
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi.qiyuesuo.com/v2/seal/autocreate' \
--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 '{
    "tenantName": "string",
    "name": "string",
    "sealImageInfo": {
        "style": "UNIVERSAL_SEAL",
        "spec": "string",
        "branchName": "string",
        "foot": "string",
        "enterpriseCode": "string",
        "enContent": "string",
        "edgeWidth": "string"
    },
    "users": [
        {
            "contact": "string",
            "contactType": "MOBILE"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

result

object

必需

string

印章ID

必需

name

string

印章名称

必需

createTime

string

创建时间

可选

格式为：yyyy-MM-dd HH:mm:ss

users

array[object (UserResponse) {3}]

可选

示例

{
  "result": {
    "id": "3053232774682116545",
    "name": "公司公章",
    "createTime": "2023-01-18 15:36:59",
    "spec": "CIRCULAR_42",
    "sealType": "ENTERPRISE",
    "status": "NORMAL"
  },
  "code": 0,
  "message": "SUCCESS"
}

印章管理-印章图片

印章管理-印章详情