开放文档API

curl -X POST 'https://your-api-host.com/seal/createSealByTemplate' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: YOUR_ACCESS_TOKEN' \
-H 'userId: OPERATOR_USER_ID' \
-d '{
  "sealName": "市场部合同专用章",
  "sealStyle": 1,
  "categoryType": "CONTRACT",
  "sealTemplateStyle": "round",
  "sealHorizontalText": "市场部",
  "sealColor": "Red"
}'
									

{
  "code": "200",
  "msg": "成功",
  "data": { // 印章创建结果
    "sealId": 50001 // 新创建的印章ID
  }
}
									

{
  "code": "SEAL_NAME_EXIST", // 示例
  "msg": "印章名称已存在",
  "data": null
}
									

# 假设已通过 uploadSealFile 上传图片并获得关联
curl -X POST 'https://your-api-host.com/seal/createSealByImage' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: YOUR_ACCESS_TOKEN' \
-H 'userId: OPERATOR_USER_ID' \
-d '{
  "sealName": "手签章-张三",
  "sealStyle": 3,
  "categoryType": "OTHER",
  "sealTemplateStyle": "round"
}'
									

{
  "code": "200",
  "msg": "成功",
  "data": { // 印章创建结果
    "sealId": 50002 // 新创建的印章ID
  }
}
									

{
  "code": "SEAL_IMAGE_NOT_FOUND", // 示例
  "msg": "未找到关联的上传印章图片",
  "data": null
}
									

curl -X POST 'https://your-api-host.com/seal/uploadSealFile?color=Red' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: YOUR_ACCESS_TOKEN' \
-H 'userId: OPERATOR_USER_ID' \
-F 'file=@/path/to/your/seal_image.png'
									

{
  "code": "200",
  "msg": "成功",
  "data": { // 文件上传结果
    "fileName": "seal_image.png",
    "fileUrl": "group1/M00/00/01/...", // 实际存储路径
    "httpUrl": "https://your-resource-host.com/group1/M00/00/01/...", // 可访问URL
    "totalPage": 1, // 图片文件通常是1页
    "width": 200, // 图片宽度
    "height": 200 // 图片高度
  }
}
									

{
  "code": "FILE_UPLOAD_ERROR", // 示例
  "msg": "文件上传失败",
  "data": null
}
									

curl -X POST 'https://your-api-host.com/seal/corpPreView' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: YOUR_ACCESS_TOKEN' \
-H 'userId: OPERATOR_USER_ID' \
-d '{
  "sealName": "预览-合同章",
  "sealStyle": 1,
  "categoryType": "CONTRACT",
  "sealColor": "Blue"
}'
									

{
  "code": "200",
  "msg": "成功",
  "data": { // 文件上传结果 (此处代表预览图信息)
    "fileName": "seal_preview.png", // 预览图文件名
    "fileUrl": "temp/preview/...", // 预览图存储路径
    "httpUrl": "https://your-resource-host.com/temp/preview/...", // 预览图URL
    "totalPage": 1,
    "width": 159, // 示例宽度
    "height": 159 // 示例高度
  }
}
									

{
  "code": "PREVIEW_GEN_ERROR", // 示例
  "msg": "生成预览图失败",
  "data": null
}
									

curl -X POST 'https://your-api-host.com/seal/uploadSealFilePreView' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: YOUR_ACCESS_TOKEN' \
-H 'userId: OPERATOR_USER_ID' \
-d '{
  "fileName": "seal_image.png",
  "httpUrl": "https://your-resource-host.com/group1/M00/00/01/...",
  "sealColor": "Black"
}'
									

{
  "code": "200",
  "msg": "成功",
  "data": { // 文件上传结果 (此处代表预览图信息)
    "fileName": "seal_preview_from_image.png",
    "fileUrl": "temp/preview/...",
    "httpUrl": "https://your-resource-host.com/temp/preview/...",
    "totalPage": 1,
    "width": 200,
    "height": 200
  }
}
									

{
  "code": "IMAGE_PROCESS_ERROR", // 示例
  "msg": "处理图片失败或找不到源文件",
  "data": null
}
									

curl -X POST 'https://your-api-host.com/seal/getSealListByPage' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: YOUR_ACCESS_TOKEN' \
-H 'userId: OPERATOR_USER_ID' \
-d '{
  "listPageNo": 1,
  "listPageSize": 5,
  "sealStatus": 1
}'
									

{
  "code": "200",
  "msg": "成功",
  "listPageNo": 1,
  "countInPage": 2,
  "listPageCount": 1,
  "totalCount": 2,
  "data": [ // 获取印章信息列表
    {
      "sealId": 50001,
      "corpName": "示例有限公司",
      "sealCode": "SEAL001",
      "sealName": "市场部合同专用章",
      "categoryType": "CONTRACT",
      "sealStyle": 1,
      "sealWidth": 159,
      "sealHeight": 159,
      "sealImageUrl": "https://your-resource-host.com/seal/50001.png",
      "defaultFlag": 0,
      "status": 1,
      "sealHorizontalText": "市场部",
      "sealBottomText": null,
      "source": "API",
      "authorNum": 3, // 授权数量
      "createTime": "2024-01-20T10:00:00.000+0800"
    },
    {
       "sealId": 50002,
       "corpName": "示例有限公司",
       "sealCode": "SEAL002",
       "sealName": "手签章-张三",
       "categoryType": "OTHER",
       "sealStyle": 3,
       "sealWidth": 200,
       "sealHeight": 200,
       "sealImageUrl": "https://your-resource-host.com/seal/50002.png",
       "defaultFlag": 1,
       "status": 1,
       "sealHorizontalText": null,
       "sealBottomText": null,
       "source": "API",
       "authorNum": 1,
       "createTime": "2024-01-21T11:00:00.000+0800"
    }
  ]
}
									

{
  "code": "QUERY_ERROR", // 示例
  "msg": "查询印章列表失败",
  "data": null
}
									

curl -X POST 'https://your-api-host.com/seal/getSealInfo' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: YOUR_ACCESS_TOKEN' \
-H 'userId: OPERATOR_USER_ID' \
-d '{
  "sealId": 50001
}'
									

{
  "code": "200",
  "msg": "成功",
  "data": { // 获取印章信息 (结构同列表查询)
    "sealId": 50001,
    "corpName": "示例有限公司",
    "sealCode": "SEAL001",
    "sealName": "市场部合同专用章",
    "categoryType": "CONTRACT",
    "sealStyle": 1,
    "sealWidth": 159,
    "sealHeight": 159,
    "sealImageUrl": "https://your-resource-host.com/seal/50001.png",
    "defaultFlag": 0,
    "status": 1,
    "sealHorizontalText": "市场部",
    "sealBottomText": null,
    "source": "API",
    "authorNum": 3,
    "createTime": "2024-01-20T10:00:00.000+0800"
  }
}
									

{
  "code": "SEAL_NOT_FOUND", // 示例
  "msg": "印章不存在",
  "data": null
}
									

curl -X POST 'https://your-api-host.com/seal/addSealAuthor' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: ADMIN_ACCESS_TOKEN' \
-H 'userId: ADMIN_USER_ID' \
-d '{
  "sealId": 50001,
  "authorMemberRange": 1,
  "userIdList": [
    {"userId": 20002},
    {"userId": 20003}
  ],
  "authorRole": "SEAL_USER",
  "authorRange": 0
}'
									

{
  "code": "200",
  "msg": "成功",
  "data": {} // 成功通常不返回业务数据
}
									

{
  "code": "AUTHOR_RULE_CONFLICT", // 示例
  "msg": "授权规则与现有规则冲突",
  "data": null
}
									

curl -X POST 'https://your-api-host.com/seal/getSealAuthorList' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: YOUR_ACCESS_TOKEN' \
-H 'userId: OPERATOR_USER_ID' \
-d '{
  "sealId": 50001,
  "listPageNo": 1,
  "listPageSize": 10
}'
									

{
  "code": "200",
  "msg": "成功",
  "listPageNo": 1,
  "countInPage": 2,
  "listPageCount": 1,
  "totalCount": 2,
  "data": [ // 获取印章授权记录信息列表
    {
      "id": 101,
      "sealId": 50001,
      "userId": 20002,
      "userName": "李四",
      "authorRole": "SEAL_USER",
      "authorRange": 0, // 全部合同
      "autoSign": 0,
      "effectiveTime": "2024-01-20T11:00:00.000+0800",
      "expireTime": null, // 永不失效
      "examinerNotify": 0,
      "status": 1, // 状态，具体值含义待确认
      "templates": null,
      "templateName": null,
      "createTime": "2024-01-20T11:00:00.000+0800"
    },
    {
      "id": 102,
      "sealId": 50001,
      "userId": 20003,
      "userName": "王五",
      "authorRole": "SEAL_EXAMINER",
      "authorRange": 1, // 指定模板
      "autoSign": 0,
      "effectiveTime": "2024-01-20T11:05:00.000+0800",
      "expireTime": "2024-12-31T23:59:59.000+0800",
      "examinerNotify": 1,
      "status": 1,
      "templates": "[{\"templateId\":1001},{\"templateId\":1002}]", // JSON 字符串
      "templateName": "报销单模板,请假单模板",
      "createTime": "2024-01-20T11:05:00.000+0800"
    }
  ]
}
									

{
  "code": "SEAL_NOT_FOUND", // 示例
  "msg": "印章不存在，无法查询授权",
  "data": null
}
									

curl -X POST 'https://your-api-host.com/seal/modify' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: YOUR_ACCESS_TOKEN' \
-H 'userId: OPERATOR_USER_ID' \
-d '{
  "sealId": 50001,
  "sealName": "市场部合同章(新)"
}'
									

{
  "code": "200",
  "msg": "成功",
  "data": {}
}
									

{
  "code": "SEAL_NAME_EXIST", // 示例
  "msg": "印章名称已存在",
  "data": null
}
									

curl -X POST 'https://your-api-host.com/seal/delete' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: ADMIN_ACCESS_TOKEN' \
-H 'userId: ADMIN_USER_ID' \
-d '{
  "sealId": 50001
}'
									

{
  "code": "200",
  "msg": "成功",
  "data": {}
}
									

{
  "code": "SEAL_DELETE_FAILED", // 示例
  "msg": "印章正在使用或有关联数据，无法删除",
  "data": null
}
									

curl -X POST 'https://your-api-host.com/seal/updDefault' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: YOUR_ACCESS_TOKEN' \
-H 'userId: OPERATOR_USER_ID' \
-d '{
  "sealId": 50002
}'
									

{
  "code": "200",
  "msg": "成功",
  "data": {}
}
									

{
  "code": "SEAL_NOT_FOUND", // 示例
  "msg": "印章不存在",
  "data": null
}
									

curl -X POST 'https://your-api-host.com/seal/getSealAuthorUrl' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: ADMIN_ACCESS_TOKEN' \
-H 'userId: ADMIN_USER_ID' \
-d '{}'
									

{
  "code": "200",
  "msg": "成功",
  "data": "https://your-system-url.com/embed/seal/manage?session=temp_session_token" // 返回管理页面链接
}
									

{
  "code": "PERMISSION_DENIED", // 示例
  "msg": "无权限访问印章管理",
  "data": null
}