Version | Update Time | Status | Author | Description
--- | --- | --- | --- | ---
v2021-11-16 12:00:32 | 2021-11-16 12:00:32 | auto | @finegirl | Created by smart-doc

## 1. 一件事微信对外服务接口

### 1.1. 一件事主题包列表

URL: http://192.168.0.217:17011/m/zwfw/proced/thing/getTopicList

Type: POST

Content-Type: application/x-www-form-urlencoded;charset=utf-8

Description: 一件事主题包列表

Query-parameters:

Parameter | Type | Description | Required | Since
--- | --- | --- | --- | ---
openId | string | 微信开放id | false | -
type | int32 | 主题包类型（1：个人服务，2：企业服务） | false | -
page | int32 | 当前请求页数 | false | -
limit | int32 | 每页记录数 | false | -
name | string | 搜索主题包名称 | false | -

Request-example:

    curl -X POST -i http://192.168.0.217:17011/m/zwfw/proced/thing/getTopicList --data 'type=309&openId=67&page=1&name=明轩.李&limit=10'

Response-fields:

Field | Type | Description | Since
--- | --- | --- | ---
code | int32 | No comments found. | -
msg | string | No comments found. | -
data | object | No comments found. | -
└─page | object | No comments found. | -
└─per | int32 | No comments found. | -
└─size | int32 | No comments found. | -
└─total | int32 | No comments found. | -
└─list | array | No comments found. | -
└─id | int64 | id | -
└─topicalName | string | 主题名称 | -
└─description | string | 主题描述信息 | -
└─topicalType | int32 | 主题类型（1 个人服务，2 企业服务） | -
└─moveIcon | string | 主题包图标 | -
└─createTime | string | 创建时间 | -

Response-example:

    {
      "code": 904,
      "msg": "t1ff2y",
      "data": {
        "page": {
          "per": 448,
          "size": 10,
          "total": 221
        },
        "list": [
          {
            "id": 376,
            "topicalName": "明轩.李",
            "description": "5v2ffo",
            "topicalType": 385,
            "moveIcon": "y1qz9k",
            "createTime": "2021-11-16 12:00:39"
          }
        ]
      }
    }

### 1.2. 一件事主题列表(包含主题包)

URL: http://192.168.0.217:17011/m/zwfw/proced/thing/oneTopiclist

Type: POST

Content-Type: application/x-www-form-urlencoded;charset=utf-8

Description: 一件事主题列表(包含主题包)

Query-parameters:

Parameter | Type | Description | Required | Since
--- | --- | --- | --- | ---
openId | string | 微信开放id | false | -
type | int32 | 主题包类型（1：个人服务，2：企业服务） | false | -
topicId | int64 | 主题包Id | false | -
page | int32 | 当前请求页数 | false | -
limit | int32 | 每页记录数 | false | -
name | string | 一件事名称 | false | -

Request-example:

    curl -X POST -i http://192.168.0.217:17011/m/zwfw/proced/thing/oneTopiclist --data 'type=518&page=1&topicId=512&openId=67&name=明轩.李&limit=10'

Response-fields:

Field | Type | Description | Since
--- | --- | --- | ---
code | int32 | No comments found. | -
msg | string | No comments found. | -
data | array | No comments found. | -
└─any object | object | any object. | -

Response-example:

    {
      "code": 222,
      "msg": "1po86d",
      "data": [
        {
          "mapKey": {
            "waring": "You may use java.util.Object for Map value; smart-doc can't be handle."
          }
        }
      ]
    }

### 1.3. 一件事列表

URL: http://192.168.0.217:17011/m/zwfw/proced/thing/getList

Type: POST

Content-Type: application/x-www-form-urlencoded;charset=utf-8

Description: 一件事列表

Query-parameters:

Parameter | Type | Description | Required | Since
--- | --- | --- | --- | ---
openId | string | 微信开放id | false | -
type | int32 | 主题包类型（1：个人服务，2：企业服务） | false | -
topicId | int64 | 主题包Id | false | -
page | int32 | 当前请求页数 | false | -
limit | int32 | 每页记录数 | false | -
name | string | 一件事名称 | false | -

Request-example:

    curl -X POST -i http://192.168.0.217:17011/m/zwfw/proced/thing/getList --data 'topicId=487&page=1&limit=10&type=458&openId=67&name=明轩.李'

Response-fields:

Field | Type | Description | Since
--- | --- | --- | ---
code | int32 | No comments found. | -
msg | string | No comments found. | -
data | object | No comments found. | -
└─page | object | No comments found. | -
└─per | int32 | No comments found. | -
└─size | int32 | No comments found. | -
└─total | int32 | No comments found. | -
└─list | array | No comments found. | -
└─id | int64 | id | -
└─name | string | 名称 | -
└─topicalType | int32 | 归属主题类型（1,个人服务，2 企业服务） | -
└─topicalName | string | 归属主题名称 | -
└─createTime | string | 创建时间 | -

Response-example:

    {
      "code": 698,
      "msg": "gj2xjj",
      "data": {
        "page": {
          "per": 463,
          "size": 10,
          "total": 834
        },
        "list": [
          {
            "id": 407,
            "name": "明轩.李",
            "topicalType": 229,
            "topicalName": "明轩.李",
            "createTime": "2021-11-16 12:00:39"
          }
        ]
      }
    }

### 1.4. 问题详细

URL: http://192.168.0.217:17011/m/zwfw/proced/thing/oneProblem

Type: POST

Content-Type: application/x-www-form-urlencoded;charset=utf-8

Description: 问题详细

Query-parameters:

Parameter | Type | Description | Required | Since
--- | --- | --- | --- | ---
openId | string | 微信开放id | false | -
id | int64 | 选中一件事ID | false | -

Request-example:

    curl -X POST -i http://192.168.0.217:17011/m/zwfw/proced/thing/oneProblem --data 'openId=67&id=72'

Response-fields:

Field | Type | Description | Since
--- | --- | --- | ---
code | int32 | No comments found. | -
msg | string | No comments found. | -
data | object | No comments found. | -
└─id | int64 | 问题与答案id,唯一 | -
└─name | string | 问题答案名称 | -
└─isLeaf | int32 | 是否为叶子节点（0：否，1：是） | -
└─isAns | int32 | 是问题还是选项答案（0：问题，1：选项答案） | -
└─parentId | int64 | 父节点id | -
└─matterIds | string | 事项id “,”号分割 | -
└─level | int32 | 树的层级 | -
└─remark | string | 备注信息 | -
└─children | array | 当前节点的子集 | -

Response-example:

    {
      "code": 121,
      "msg": "wrh73f",
      "data": {
        "id": 428,
        "name": "明轩.李",
        "isLeaf": 553,
        "isAns": 494,
        "parentId": 927,
        "matterIds": "xq3hxl",
        "level": 52,
        "remark": "ozmo7x",
        "children": [
          {
            "$ref": ".."
          }
        ]
      }
    }

### 1.5. 问答答案提交后返回的详细结果

URL: http://192.168.0.217:17011/m/zwfw/proced/thing/ansResults

Type: POST

Content-Type: application/x-www-form-urlencoded;charset=utf-8

Description: 问答答案提交后返回的详细结果

Query-parameters:

Parameter | Type | Description | Required | Since
--- | --- | --- | --- | ---
openId | string | 微信开放id | false | -
optionIds | array | 问答最后答案选项ID（多问题线） | false | -
classifyId | int64 | 主题事项Id | false | -

Request-example:

    curl -X POST -i http://192.168.0.217:17011/m/zwfw/proced/thing/ansResults --data 'openId=67&classifyId=941'

Response-fields:

Field | Type | Description | Since
--- | --- | --- | ---
code | int32 | No comments found. | -
msg | string | No comments found. | -
data | object | No comments found. | -
└─basicsInfo | object | 基本信息 | -
└─moveIcon | string | 移动主题包图标 | -
└─presenceNum | int32 | 到现场次数 | -
└─jointInfoShow | string | 办理机构 | -
└─legalTimeLimitShow | string | 法定时限 | -
└─promiseTimeLimitShow | string | 承诺时限 | -
└─isChargesShow | string | 收费标准 | -
└─charges | string | 收费金额 | -
└─handleTimeShow | string | 办理时间 | -
└─handlePlaceShow | string | 办理地点 | -
└─cousultingTelephoneShow | string | 咨询方式 | -
└─resultInfo | string | 结果信息 | -
└─supervisoryTelephoneShow | string | 投诉电话 | -
└─matterInfoList | array | 事项列表列表 | -
└─id | int64 | 事项id | -
└─matterName | string | 事项名称 | -
└─acceptInfoList | array | 受理条件列表 | -
└─matterId | int64 | 事项id | -
└─title | string | 受理条件 | -
└─content | string | 受理条件 | -
└─flowLimitInfoList | array | 办理流程列表 | -
└─matterId | int64 | 事项matter id | -
└─flowName | string | 办理流程 | -
└─flowTime | string | 办理时长 | -
└─flowTurnOut | string | 转外时限 | -
└─flowDesc | string | 办理流程说明 | -
└─datumInfoList | array | 事项材料列表 | -
└─id | int64 | 材料id | -
└─materialName | string | 材料名 | -
└─matterId | int64 | 事项Id | -
└─materialProperty | string | 材料形式 | -
└─isMust | string | 是否必交，0 否 1 是 默认0 | -
└─materialType | string | 材料类型 | -
└─electronicgs | string | 电子材料格式 | -
└─materialSource | string | 材料来源渠道 | -
└─paperNum | int32 | 纸质材料份数 | -
└─paperGg | string | 纸质材料规格 | -
└─jianmMs | string | 减免模式 | -
└─sealWay | string | 盖章方式 | -
└─isjianm | string | 是否减免 | -
└─isLack | string | 材料是否容缺 | -
└─materialSourceSm | string | 来源渠道说明 | -
└─remarkSub | string | 填报须知 | -
└─remark | string | 受理标准 | -
└─clauseContent | string | 要求提供材料的依据 | -
└─summary | string | 备注 | -
└─createTime | string | 材料创建时间 | -
└─attachList | array | No comments found. | -
└─datumid | int64 | 材料id | -
└─fileName | string | 附件名称 | -
└─fileUrl | string | 附件下载地址 | -
└─filetype | int32 | 附件类型 1 示例样表 2空白表格 默认1 | -
└─qAndAInfoList | array | 常见问题列表 | -
└─matterId | int64 | 事项id | -
└─question | string | 问题 | -
└─answer | string | 回答 | -

Response-example:

    {
      "code": 230,
      "msg": "yga4zm",
      "data": {
        "basicsInfo": {
          "moveIcon": "ni40s1",
          "presenceNum": 202,
          "jointInfoShow": "8unwqz",
          "legalTimeLimitShow": "hlta4h",
          "promiseTimeLimitShow": "1p99sa",
          "isChargesShow": "nsa4fq",
          "charges": "oe5cyu",
          "handleTimeShow": "a3t39w",
          "handlePlaceShow": "xmseib",
          "cousultingTelephoneShow": "3rqs8i",
          "resultInfo": "7g43bd",
          "supervisoryTelephoneShow": "euygqt"
        },
        "matterInfoList": [
          {
            "id": 233,
            "matterName": "明轩.李"
          }
        ],
        "acceptInfoList": [
          {
            "matterId": 295,
            "title": "c48vya",
            "content": "secq2c"
          }
        ],
        "flowLimitInfoList": [
          {
            "matterId": 173,
            "flowName": "明轩.李",
            "flowTime": "2021-11-16 12:00:39",
            "flowTurnOut": "98beoy",
            "flowDesc": "1ey9q1"
          }
        ],
        "datumInfoList": [
          {
            "id": 21,
            "materialName": "明轩.李",
            "matterId": 31,
            "materialProperty": "jmw3wv",
            "isMust": "6jrjoi",
            "materialType": "5mxc28",
            "electronicgs": "73pzdr",
            "materialSource": "6z65zo",
            "paperNum": 627,
            "paperGg": "bilxu9",
            "jianmMs": "nzopo7",
            "sealWay": "pdb7l7",
            "isjianm": "e43h82",
            "isLack": "9elj4w",
            "materialSourceSm": "ronlqz",
            "remarkSub": "wusyj4",
            "remark": "kt8ra0",
            "clauseContent": "o20gz4",
            "summary": "3st1w8",
            "createTime": "2021-11-16 12:00:40",
            "attachList": [
              {
                "datumid": 618,
                "fileName": "明轩.李",
                "fileUrl": "www.xn---xn--7mz-s41mk45h.biz",
                "filetype": 550
              }
            ]
          }
        ],
        "qAndAInfoList": [
          {
            "matterId": 100,
            "question": "4ytivk",
            "answer": "snnfgg"
          }
        ]
      }
    }

### 1.6. 上传附件

URL: http://192.168.0.217:17011/m/zwfw/proced/thing/uploadFile

Type: POST

Content-Type: multipart/form-data

Description: 上传附件

Query-parameters:

Parameter | Type | Description | Required | Since
--- | --- | --- | --- | ---
file | file | No comments found. | true | -

Request-example:

    curl -X POST -H 'Content-Type: multipart/form-data' -i http://192.168.0.217:17011/m/zwfw/proced/thing/uploadFile

Response-fields:

Field | Type | Description | Since
--- | --- | --- | ---
code | int32 | No comments found. | -
msg | string | No comments found. | -
data | object | No comments found. | -

Response-example:

    {
      "code": 799,
      "msg": "hjxsy5",
      "data": {
        "mapKey1": "suohzy",
        "mapKey2": "rxihze"
      }
    }

### 1.7. 删除附件

URL: http://192.168.0.217:17011/m/zwfw/proced/thing/delFile

Type: POST

Content-Type: application/x-www-form-urlencoded;charset=utf-8

Description: 删除附件

Query-parameters:

Parameter | Type | Description | Required | Since
--- | --- | --- | --- | ---
openId | string | 微信开放id | false | -
filePath | string | 文件路径 | false | -

Request-example:

    curl -X POST -i http://192.168.0.217:17011/m/zwfw/proced/thing/delFile --data 'filePath=1j3p3s&openId=67'

Response-fields:

Field | Type | Description | Since
--- | --- | --- | ---
code | int32 | No comments found. | -
msg | string | No comments found. | -
data | object | No comments found. | -

Response-example:

    {
      "code": 505,
      "msg": "s6khw1",
      "data": "56jr1w"
    }

### 1.8. 查询用户信息

URL: http://192.168.0.217:17011/m/zwfw/proced/thing/searchMember

Type: POST

Content-Type: application/x-www-form-urlencoded;charset=utf-8

Description: 查询用户信息

Query-parameters:

Parameter | Type | Description | Required | Since
--- | --- | --- | --- | ---
openId | string | 微信开放id | false | -

Request-example:

    curl -X POST -i http://192.168.0.217:17011/m/zwfw/proced/thing/searchMember --data 'openId=67'

Response-fields:

Field | Type | Description | Since
--- | --- | --- | ---
code | int32 | No comments found. | -
msg | string | No comments found. | -
data | object | No comments found. | -
└─id | object | No comments found. | -
└─createTime | string | 创建时间 | -
└─createUser | string | 创建用户 | -
└─createUserId | int64 | No comments found. | -
└─deleted | int32 | No comments found. | -
└─createUserName | string | 创建用户名称 | -
└─createUserDeptId | int64 | No comments found. | -
└─createUserDeptName | string | No comments found. | -
└─updateTime | string | No comments found. | -
└─updateUser | string | No comments found. | -
└─updateUserId | int64 | No comments found. | -
└─updateUserName | string | No comments found. | -
└─updateUserDeptId | int64 | No comments found. | -
└─updateUserDeptName | string | No comments found. | -
└─idcardName | string | 姓名 | -
└─idcardSex | string | 性别 | -
└─idcardNation | string | 民族 | -
└─idcardBorn | string | 出生 | -
└─idcardAddress | string | 地址 | -
└─idcardIDCardNo | string | 身份证号 | -
└─idcardGrantDept | string | 发证机关 | -
└─idcardUserLifeBegin | string | 有效期开始 | -
└─idcardUserLifeEnd | string | 有效期结束 | -
└─idcardDataPhotoFileName | string | 照片 | -
└─phone | string | 手机号 | -
└─unionid | string | unionid，同一个微信开放平台的唯一标识 | -
└─openId | string | 微信openId | -
└─picImage | string | 头像地址 | -
└─nickname | string | 昵称 | -
└─realName | string | 真实姓名 | -
└─gender | string | 1：男，2：女 | -
└─icon | string | 微信头像 | -
└─zImg | string | 身份证正面照片 | -
└─bImg | string | 身份证背面照片 | -
└─siteid | int64 | 默认选择的站点id | -
└─username | string | 天府通办用户名 | -
└─lasttime | string | 最后登录时间 | -
└─remark | string | 备注 | -
└─status | int32 | 用户状态，0:正常，1:禁用,默认0 | -

Response-example:

    {
      "code": 347,
      "msg": "iplbt2",
      "data": {
        "id": "igrqmz",
        "createTime": "2021-11-16 12:00:41",
        "createUser": "e11mn6",
        "createUserId": 55,
        "deleted": 217,
        "createUserName": "明轩.李",
        "createUserDeptId": 37,
        "createUserDeptName": "明轩.李",
        "updateTime": "2021-11-16 12:00:41",
        "updateUser": "thtli9",
        "updateUserId": 129,
        "updateUserName": "明轩.李",
        "updateUserDeptId": 773,
        "updateUserDeptName": "明轩.李",
        "idcardName": "明轩.李",
        "idcardSex": "c00s8l",
        "idcardNation": "vr1k1p",
        "idcardBorn": "ithxrj",
        "idcardAddress": "Suite 139 段中心4610号， 济宁， 赣 424588",
        "idcardIDCardNo": "0pg241",
        "idcardGrantDept": "mzrgsh",
        "idcardUserLifeBegin": "o2vxea",
        "idcardUserLifeEnd": "2toiqe",
        "idcardDataPhotoFileName": "明轩.李",
        "phone": "17144806078",
        "unionid": "67",
        "openId": "67",
        "picImage": "epykjh",
        "nickname": "tuyet.koss",
        "realName": "明轩.李",
        "gender": "f5owvp",
        "icon": "o9kmct",
        "zImg": "vsi9qm",
        "bImg": "fcwr09",
        "siteid": 439,
        "username": "明轩.李",
        "lasttime": "2021-11-16 12:00:41",
        "remark": "ovdvjn",
        "status": 397
      }
    }

### 1.9. 一件事办理资料提交

URL: http://192.168.0.217:17011/m/zwfw/proced/thing/submitDatum

Type: POST

Content-Type: application/x-www-form-urlencoded;charset=utf-8

Description: 一件事办理资料提交

Query-parameters:

Parameter | Type | Description | Required | Since
--- | --- | --- | --- | ---
openId | string | 微信开放id | false | -
classifyTopicId | int64 | 申请主题id | false | -
siteId | int64 | 站点ID | false | -
name | string | 申请人姓名 | false | -
phone | string | 电话 | false | -
idcard | string | 身份证 | false | -
isAgent | int32 | 0本人办理 1代办 | false | -
manner | int32 | 0自主取件 1代办领取 (取件方式) | false | -
matterReqList | array | 申请事项列表 | false | -
└─matterid | int64 | 事项ID | false | -
└─attachmentList | array | 申请材料列表 | false | -
└─datumId | int64 | 材料id | false | -
└─fileName | string | 附件名称 | false | -
└─filepath | string | 附件存储地址 | false | -

Request-example:

    curl -X POST -i http://192.168.0.217:17011/m/zwfw/proced/thing/submitDatum --data 'matterReqList[0].attachmentList[0].filepath=2m1vxk&idcard=511704199003249407&siteId=851&name=明轩.李&phone=17144806078&manner=948&matterReqList[0].attachmentList[0].datumId=541&matterReqList[0].matterid=755&openId=67&isAgent=391&matterReqList[0].attachmentList[0].fileName=明轩.李&classifyTopicId=776'

Response-fields:

Field | Type | Description | Since
--- | --- | --- | ---
code | int32 | No comments found. | -
msg | string | No comments found. | -
data | object | No comments found. | -

Response-example:

    {
      "code": 61,
      "msg": "m2egib",
      "data": "mfsyqa"
    }

### 1.10. 我的办理

URL: http://192.168.0.217:17011/m/zwfw/proced/thing/myHandle

Type: POST

Content-Type: application/x-www-form-urlencoded;charset=utf-8

Description: 我的办理

Query-parameters:

Parameter | Type | Description | Required | Since
--- | --- | --- | --- | ---
openId | string | 微信开放id | false | -

Request-example:

    curl -X POST -i http://192.168.0.217:17011/m/zwfw/proced/thing/myHandle --data 'openId=67'

Response-fields:

Field | Type | Description | Since
--- | --- | --- | ---
code | int32 | No comments found. | -
msg | string | No comments found. | -
data | array | No comments found. | -
└─processInstanceId | string | 审核流程id | -
└─memberId | int64 | 微信用户ID | -
└─openId | string | 微信OPENID | -
└─classifyName | string | 申请主题名称 | -
└─address | string | 邮寄地址 | -
└─linkman | string | 联系人 | -
└─phone | int32 | 联系电话 | -
└─manner | int32 | 取件方式 0自主取件 1邮寄 | -
└─getnum | string | 取件码 | -
└─number | string | 快递单号 | -
└─isAgent | int32 | 是否代办 0是本人办理 1他人代办 | -
└─isRevoke | int32 | 是否撤销,0否， 1是 | -
└─siteid | int32 | 站点ID | -
└─status | int32 | 审批状态 0未审核 1 审核中 2 审核成功 | -
└─createTime | string | 创建时间 | -

Response-example:

    {
      "code": 362,
      "msg": "foam58",
      "data": [
        {
          "processInstanceId": "67",
          "memberId": 779,
          "openId": "67",
          "classifyName": "明轩.李",
          "address": "Suite 139 段中心4610号， 济宁， 赣 424588",
          "linkman": "8mdydu",
          "phone": 261,
          "manner": 834,
          "getnum": "6l1axw",
          "number": "33yzlc",
          "isAgent": 677,
          "isRevoke": 958,
          "siteid": 837,
          "status": 164,
          "createTime": "2021-11-16 12:00:41"
        }
      ]
    }

## 2. 微信认证

### 2.1. 微信注册认证

URL: http://192.168.0.217:17011/m/zwfw/wechatinter/base/checkCard

Type: POST

Content-Type: application/x-www-form-urlencoded;charset=utf-8

Description: 微信注册认证

Query-parameters:

Parameter | Type | Description | Required | Since
--- | --- | --- | --- | ---
sitenum | string | 站点编号 | false | -
openid | string | 微信openid | false | -
idcard | string | 身份证 | false | -
tel | string | 电话 | false | -
name | string | 姓名 | false | -
file | string | 人脸照片地址 | false | -
z_img | string | 身份证正面照片地址 | false | -
b_img | string | 身份证反面照片地址 | false | -
siteid | int64 | 站点id (对站点进行绑定) | false | -

Request-example:

    curl -X POST -i http://192.168.0.217:17011/m/zwfw/wechatinter/base/checkCard --data 'openid=67&idcard=511704199003249407&sitenum=ynyqp6&file=0h5xtb&tel=7szxtl&name=明轩.李&b_img=fmlsa9&z_img=yr8jin&siteid=541'

Response-fields:

Field | Type | Description | Since
--- | --- | --- | ---
code | int32 | No comments found. | -
msg | string | No comments found. | -
data | object | No comments found. | -

Response-example:

    {
      "code": 355,
      "msg": "aasunq",
      "data": "7ti81q"
    }

## 3. 错误码列表

Error code | Description
--- | ---
200 | ok
400 | Bad Request
401 | Unauthorized
403 | Forbidden
404 | Not Found
415 | Unsupported Media Type
500 | Internal Server Error
502 | Bad Gateway
503 | Service Unavailable

Top