接口设计

全局参数

Header 参数及说明

参数名	示例值	参数描述
Authorization	Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4 MywiaWF0IjoxNjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0Mjcy OTY4MTgzNDZlMGI3ZTFkOSJ9.Nto SzzebwntHV2W9fskNJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021b JGIVvcS6s_qo8S16T0J2zxnjX0_g	管理用户认证 token 值
Tenant	214231	租户 ID

交易中心

交易中心管理列表分页查询

基本信息

接口状态：未开始
接口 URI: /api/trade_center?uuid=2Ba7C78d-77Ff-e25b-183B-eF8795509bdd&page=1&limit=10&name=交易中心
请求方式：GET
Content-Type: application/json

请求参数

• Query 参数及说明

参数名	示例值	参数类型	是否必填	参数描述
uuid	2Ba7C78d-77Ff-e25b-183B-eF8795509bdd	String	是	请求 uuid
page	1	Integer	是	页码
limit	10	Integer	是	每页数据量
name	交易中心	String	否	交易中心名称查询参数

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200,
  "msg": "查询成功!",
  "uuid": "2Ba7C78d-77Ff-e25b-183B-eF8795509bdd",
  "data": {
    "total": 3,
    "tradeCenters": [
      {
        "id": 55,
        "fullName": "樟树市交易中心",
        "shortName": "交易中心",
        "address": "台湾 桃园县",
        "telephone": "010-85709947",
        "fax": "010-71600083",
        "email": "m.fjuqbxcusc@163.com"
      },
      {
        "id": 79,
        "fullName": "隆回县交易中心",
        "shortName": "交易中心",
        "address": "江西省 吉安市",
        "telephone": "010-48947890",
        "fax": "010-22331863",
        "email": "n.nuydjt@163.com"
      },
      {
        "id": 86,
        "fullName": "油尖旺区交易中心",
        "shortName": "交易中心",
        "address": "河南省 洛阳市",
        "telephone": "010-81495114",
        "fax": "010-94143463",
        "email": "y.nsyo@163.com"
      }
    ]
  }
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功代码
msg	查询成功!	String	响应消息
uuid	2Ba7C78d-77Ff-e25b-183B-eF8795509bdd	String	请求 uuid
data	{}	Object	返回数据对象
data.total	3	Integer	总数据量
data.tradeCenters	[]	Array	交易中心数据列表
data.tradeCenters.id	55	Integer	交易中心主键
data.tradeCenters.fullName	樟树市交易中心	String	交易中心全称
data.tradeCenters.shortName	交易中心	String	交易中心简称
data.tradeCenters.address	樟树市	String	交易中心地址
data.tradeCenters.telephone	010-85709947	String	电话号码
data.tradeCenters.fax	010-71600083	String	传真
data.tradeCenters.email	m.fjuqbxcusc@163.com	String	电子邮箱，比如 example@qq.com

• 失败响应示例

{
  "code": 500,
  "msg": "查询失败!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {}
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	查询失败!	String	响应消息
uuid	2Ba7C78d-77Ff-e25b-183B-eF8795509bdd	String	请求 uuid
data	{}	Object	返回数据对象

新增交易中心

基本信息

接口状态：未开始
接口 URI: /api/trade_center
请求方式：POST
Content-Type: application/json

请求参数

• Body 参数及说明

{
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "param": {
    "code": "TC-210231",
    "fullName": "辽宁省沈阳市农交中心",
    "shortName": "沈阳农交中心",
    "address": "沈阳市沈河区奉天街328号（301室）",
    "telephone": "024-22566048",
    "fax": "+86 571-8705 4509",
    "email": "shenyangcj@163.com"
  }
}

• 字段描述

参数名	示例值	参数类型	是否必填	参数描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	是	请求 uuid
param	{}	Object	是	请求参数
param.code	TC-210231	String	是	交易中心编码
param.fullName	辽宁省沈阳市农交中心	String	是	交易中心全称
param.shortName	沈阳农交中心	String	否	交易中心简称
param.address	沈阳市沈河区奉天街 328 号（301 室）	String	是	交易中心地址
param.telephone	024-22566048	String	是	电话号码
param.fax	+86 571-8705 4509	String	否	传真
param.email	shenyangcj@163.com	String	否	电子邮箱，比如 example@qq.com

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200,
  "msg": "添加交易中心成功!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {
    "id": 783
  }
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功代码
msg	添加交易中心成功!	String	响应消息
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据对象
data.id	783	Integer	交易中心主键 id

• 失败响应示例

{
  "code": 500,
  "msg": "添加交易中心失败!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {}
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	添加交易中心失败!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据

修改交易中心

基本信息

接口状态：未开始
接口 URI: /api/trade_center
请求方式：PUT
Content-Type: application/json

请求参数

• Body 参数及说明

{
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "param": {
    "id": 712,
    "fullName": "辽宁省沈阳市农交中心",
    "shortName": "沈阳农交中心",
    "address": "沈阳市沈河区奉天街328号（301室）",
    "telephone": "024-22566048",
    "fax": "+86 571-8705 4509",
    "email": "shenyangcj@163.com"
  }
}

• 字段描述

参数名	示例值	参数类型	是否必填	参数描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	是	请求 uuid
param	{}	Object	是	请求参数
param.id	712	Integer	是	交易中心主键 id
param.fullName	辽宁省沈阳市农交中心	String	否	交易中心全称
param.shortName	沈阳农交中心	String	否	交易中心简称
param.address	沈阳市沈河区奉天街 328 号（301 室）	String	否	交易中心地址
param.telephone	024-22566048	String	否	电话号码
param.fax	+86 571-8705 4509	String	否	传真
param.email	shenyangcj@163.com	String	否	电子邮箱，比如 example@qq.com

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200,
  "msg": "修改交易中心成功!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {
    "id": 712
  }
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功代码
msg	修改交易中心成功!	String	响应消息
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据对象
data.id	712	Integer	交易中心主键 id

• 失败响应示例

{
  "code": 500,
  "msg": "修改交易中心失败!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {}
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	修改交易中心失败!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据

删除交易中心

基本信息

接口状态：未开始
接口 URI: /api/trade_center
请求方式：DELETE
Content-Type: application/json

请求参数

• 路径参数及说明

参数名	示例值	参数类型	是否必填	参数描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	是	请求 uuid
id	712	Integer	是	交易中心主键 id

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200,
  "msg": "删除交易中心成功!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {
    "id": 712
  }
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功代码
msg	删除交易中心成功!	String	响应消息
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据对象
data.id	712	Integer	交易中心主键 id

• 失败响应示例

{
  "code": 500,
  "msg": "删除交易中心失败!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {}
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	删除交易中心失败!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据

查询交易中心联系人

基本信息

接口状态：未开始
接口 URI: /api/trade_center/contact?uuid=1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1&code=TC-210231
请求方式：GET
Content-Type: application/json

请求参数

• Query 参数及说明

参数名	示例值	参数类型	是否必填	参数描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	是	请求 uuid
code	TC-210231	String	是	交易中心编码

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200,
  "msg": "查询交易中心联系人成功!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {
    "total": 2,
    "tradeCenterContacts": [
      {
        "id": 785,
        "code": "TC-210231",
        "linkman": "范敏",
        "phone": "15812344321"
      },
      {
        "id": 782,
        "code": "TC-210231",
        "linkman": "陆静",
        "phone": "15812355321"
      }
    ]
  }
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功代码
msg	查询交易中心联系人成功!	String	响应消息
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据对象
data.total	2	Integer	交易中心联系人数据量
data.tradeCenterContacts	[]	Object	交易中心联系人数组
data.tradeCenterContacts.id	785	Integer	交易中心主键 id
data.tradeCenterContacts.code	TC-210231	String	交易中心编码
data.tradeCenterContacts.linkman	范敏	String	联系人
data.tradeCenterContacts.phone	15812344321	String	联系电话

• 失败响应示例

{
  "code": 500,
  "msg": "查询交易中心联系人失败!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {}
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	查询交易中心联系人失败!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据

新增交易中心联系人

基本信息

接口状态：未开始
接口 URI: /api/trade_center/contact
请求方式：POST
Content-Type: application/json

请求参数

• Body 参数及说明

{
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "param": {
    "code": "TC-210231",
    "linkman": "林丽",
    "phone": "13212341234"
  }
}

• 字段描述

参数名	示例值	参数类型	是否必填	参数描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	是	请求 uuid
param	{}	Object	是	请求参数
param.code	TC-210231	String	是	交易中心编码
param.linkman	林丽	String	是	联系人
param.phone	13212341234	String	是	联系电话

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200,
  "msg": "添加交易中心联系人成功!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {
    "id": 2753
  }
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功代码
msg	添加交易中心联系人成功!	String	响应消息
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据对象
data.id	2753	Integer	交易中心联系人主键 id

• 失败响应示例

{
  "code": 500,
  "msg": "添加交易中心联系人失败!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {}
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	添加交易中心联系人失败!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据

修改交易中心联系人

基本信息

接口状态：未开始
接口 URI: /api/trade_center/contact
请求方式：PUT
Content-Type: application/json

请求参数

• Body 参数及说明

{
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "param": {
    "id": 2753,
    "linkman": "林丽",
    "phone": "13212341234"
  }
}

• 字段描述

参数名	示例值	参数类型	是否必填	参数描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	是	请求 uuid
param	{}	Object	是	请求参数
param.id	2753	Integer	是	交易中心联系人主键 id
param.linkman	林丽	String	是	联系人
param.phone	13212341234	String	是	联系电话

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200,
  "msg": "修改交易中心联系人成功!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {
    "id": 2753
  }
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功代码
msg	修改交易中心联系人成功!	String	响应消息
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据对象
data.id	2753	Integer	交易中心联系人主键 id

• 失败响应示例

{
  "code": 500,
  "msg": "修改交易中心联系人失败!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {}
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	修改交易中心联系人失败!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据

删除交易中心联系人

基本信息

接口状态：未开始
接口 URI: /api/trade_center/contact/:uuid/:id
请求方式：DELETE
Content-Type: application/json

请求参数

• 路径参数及说明

参数名	示例值	参数类型	是否必填	参数描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	是	请求 uuid
id	2753	Integer	是	交易中心联系人主键 id

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200,
  "msg": "删除交易中心联系人成功!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {
    "id": 2753
  }
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功代码
msg	删除交易中心联系人成功!	String	响应消息
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据对象
data.id	2753	Integer	交易中心联系人主键 id

• 失败响应示例

{
  "code": 500,
  "msg": "删除交易中心联系人失败!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {}
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	删除交易中心联系人失败!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据

查询交易中心银行账户

基本信息

接口状态：未开始
接口 URI: /api/trade_center/bank?uuid=1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1&code=TC-210231
请求方式：GET
Content-Type: application/json

请求参数

• Query 参数及说明

参数名	示例值	参数类型	是否必填	参数描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	是	请求 uuid
code	TC-210231	String	是	交易中心编码

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200,
  "msg": "查询交易中心银行账户成功!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {
    "total": 2,
    "tradeCenterBanks": [
      {
        "id": 782,
        "code": "TC-210231",
        "depositBank": "建设银行",
        "accountName": "大连农交中心",
        "acount": "6226123442124431123"
      },
      {
        "id": 782,
        "code": "TC-210231",
        "depositBank": "招商银行",
        "accountName": "沈阳农交中心",
        "acount": "6225123442124431861"
      }
    ]
  }
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功代码
msg	查询交易中心联系人成功!	String	响应消息
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据对象
data.total	2	Integer	交易中心联系人数据量
data.tradeCenterBanks	[]	Object	交易中心银行账户数组
data.tradeCenterBanks.id	782	Integer	交易中心银行账户主键 id
data.tradeCenterBanks.code	TC-210231	String	交易中心编码
data.tradeCenterBanks.depositBank	建设银行	String	开户行
data.tradeCenterBanks.accountName	大连农交中心	String	户名
data.tradeCenterBanks.acount	6226123442124431123	String	账户

• 失败响应示例

{
  "code": 500,
  "msg": "查询交易中心银行账户失败!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {}
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	查询交易中心银行账户失败!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据

新增交易中心银行账户

基本信息

接口状态：未开始
接口 URI: /api/trade_center/bank
请求方式：POST
Content-Type: application/json

请求参数

• Body 参数及说明

{
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "param": {
    "code": "TC-210231",
    "depositBank": "建设银行",
    "accountName": "大连农交中心",
    "acount": "6226123442124431123"
  }
}

• 字段描述

参数名	示例值	参数类型	是否必填	参数描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	是	请求 uuid
param	{}	Object	是	请求参数
param.code	TC-210231	String	是	交易中心编码
param.depositBank	建设银行	String	是	开户行
param.accountName	大连农交中心	String	是	户名
param.acount	6226123442124431123	String	是	账户

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200,
  "msg": "添加交易中心银行账户成功!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {
    "id": 966
  }
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功代码
msg	添加交易中心银行账户成功!	String	响应消息
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据对象
data.id	966	Integer	交易中心银行账户主键 id

• 失败响应示例

{
  "code": 500,
  "msg": "添加交易中心银行账户失败!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {}
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	添加交易中心银行账户失败!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据

修改交易中心银行账户

基本信息

接口状态：未开始
接口 URI: /api/trade_center/bank
请求方式：PUT
Content-Type: application/json

请求参数

• Body 参数及说明

{
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "param": {
    "id": 966,
    "depositBank": "建设银行",
    "accountName": "大连农交中心",
    "acount": "6226123442124431123"
  }
}

• 字段描述

参数名	示例值	参数类型	是否必填	参数描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	是	请求 uuid
param	{}	Object	是	请求参数
param.id	966	Integer	是	交易中心联系人主键 id
param.depositBank	建设银行	String	否	开户行
param.accountName	大连农交中心	String	否	户名
param.acount	6226123442124431123	String	否	账户

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200,
  "msg": "修改交易中心银行账户成功!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {
    "id": 966
  }
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功代码
msg	修改交易中心银行账户成功!	String	响应消息
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据对象
data.id	966	Integer	交易中心联系人主键 id

• 失败响应示例

{
  "code": 500,
  "msg": "修改交易中心银行账户失败!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {}
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	修改交易中心银行账户失败!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据

删除交易中心银行账户

基本信息

接口状态：未开始
接口 URI: /api/trade_center/bank/:uuid/:id
请求方式：DELETE
Content-Type: application/json

请求参数

• 路径参数及说明

参数名	示例值	参数类型	是否必填	参数描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	是	请求 uuid
id	966	Integer	是	交易中心银行账户主键 id

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200,
  "msg": "删除交易中心银行账户成功!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {
    "id": 966
  }
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功代码
msg	删除交易中心银行账户成功!	String	响应消息
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据对象
data.id	966	Integer	交易中心银行账户主键 id

• 失败响应示例

{
  "code": 500,
  "msg": "删除交易中心银行账户失败!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {}
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	删除交易中心银行账户失败!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据

供方管理

查询供方列表

基本信息

接口状态：未开始
接口 URI: /api/vendor?uuid=2Ba7C78d-77Ff-e25b-183B-eF8795509bdd&page=1&limit=10&name=村集体
请求方式：GET
Content-Type: application/json

请求参数

• Query 参数及说明

参数名	示例值	参数类型	是否必填	参数描述
uuid	2Ba7C78d-77Ff-e25b-183B-eF8795509bdd	String	是	请求 uuid
page	1	Integer	是	页码
limit	10	Integer	是	每页数据量
name	村集体	String	否	供方名称查询参数

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200,
  "msg": "查询成功!",
  "uuid": "2Ba7C78d-77Ff-e25b-183B-eF8795509bdd",
  "data": {
    "total": 4,
    "vendors": [
      {
        "id": 809,
        "code": "V89360426",
        "fullName": "邓平",
        "shortName": "",
        "classify": "person"
      },
      {
        "id": 406,
        "code": "V92995933",
        "fullName": "隆回县村集体",
        "shortName": "隆回集体",
        "classify": "collective"
      },
      {
        "id": 153,
        "code": "V19997065",
        "fullName": "油尖旺区交合作社",
        "shortName": "油尖旺合作社",
        "classify": "artel"
      },
      {
        "id": 768,
        "code": "V78693552",
        "fullName": "沈阳农科有限公司",
        "shortName": "沈阳农科",
        "classify": "company"
      }
    ]
  }
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功代码
msg	查询成功!	String	响应消息
uuid	2Ba7C78d-77Ff-e25b-183B-eF8795509bdd	String	请求 uuid
data	{}	Object	返回数据对象
data.total	4	Integer	总数据量
data.vendors	[]	Object	供方数组
data.vendors.id	809	Integer	供方主键 id
data.vendors.code	V89360426	String	供方编码
data.vendors.fullName	邓平	String	供方全称
data.vendors.shortName	-	Object	供方简称
data.vendors.classify	person	String	供方类型

• 失败响应示例

{
  "code": 500,
  "msg": "查询失败!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {}
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	查询失败!	String	响应消息
uuid	2Ba7C78d-77Ff-e25b-183B-eF8795509bdd	String	请求 uuid
data	{}	Object	返回数据对象

新增供方

基本信息

接口状态：未开始
接口 URI: /api/vendor
请求方式：POST
Content-Type: application/json

请求参数

• Body 参数及说明

• 新增个人

{
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "param": {
    "code": "V76366194", //供方编码
    "fullName": "卢军", //供方全称
    "shortName": "", //供方简称
    "classify": "person", //供方类型: person-个人, artel-合作社, collective-村集体, company-公司
    "detail": {
      "vendorCode": "V76366194", //供方编码
      "idType": "id", //证件类型
      "idNumber": "412825199109099121", //证件号码
      "phone": "15100001232", //联系电话
      "address": "商洛市", //地址
      "email": "c.wkceafo@163.com" //电子邮箱，比如 example@qq.com
    }, //个人
    "contacts": [
      {
        "vendorCode": "V76366194", //供方编码
        "linkman": "何明", //联系人
        "linkmanPhone": "17212344321", //联系电话
        "linkmanIdType": "id", //联系人证件类型
        "linkmanIdNumber": "412728199209029211", //联系人证件号码
        "linkmanAddress": "云南省 文山壮族苗族自治州" //地址
      }
    ], //联系方式
    "attachments": [
      {
        "vendorCode": "V76366194", //供方编码
        "attachmentClassify": "id_front", //附件类型
        "name": "身份证国徽面", //文件名
        "path": "/file/id_front/3241234351235.jpg" //文件路径
      },
      {
        "vendorCode": "V76366194", //供方编码
        "attachmentClassify": "id_reverse", //附件类型
        "name": "身份证国徽面", //文件名
        "path": "/file/id_reverse/3241234351235.jpg" //文件路径
      }
    ] //附件数组
  } //请求参数
}

• 新增集体

{
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "param": {
    "code": "V76366194", //供方编码
    "fullName": "卢军", //供方全称
    "shortName": "", //供方简称
    "classify": "collective", //供方类型: person-个人, artel-合作社, collective-村集体, company-公司
    "detail": {
      "vendorCode": "V76366194", //供方编码
      "unifySocialCreditCode": "9135052155323005XL", //统一社会信用代码
      "phone": "010-66261242", //联系电话
      "fax": "+86+010+26737", //传真
      "address": "吉林省 吉林市", //地址
      "email": "q.wawhaikpwd@163.com", //电子邮箱，比如 example@qq.com
      "legalPerson": "马敏", //法人
      "legalPersonIdType": "id", //法人证件类型
      "legalPersonIdNumber": "021021199309099132" //法人证件号码
    }, //村集体
    "contacts": [
      {
        "vendorCode": "V76366194", //供方编码
        "linkman": "何明", //联系人
        "linkmanPhone": "17212344321", //联系电话
        "linkmanIdType": "id", //联系人证件类型
        "linkmanIdNumber": "412728199209029211", //联系人证件号码
        "linkmanAddress": "云南省 文山壮族苗族自治州" //地址
      }
    ], //联系方式
    "attachments": [
      {
        "vendorCode": "V76366194", //供方编码
        "attachmentClassify": "id_front", //附件类型
        "name": "身份证国徽面", //文件名
        "path": "/file/id_front/3241234351235.jpg" //文件路径
      },
      {
        "vendorCode": "V76366194", //供方编码
        "attachmentClassify": "id_reverse", //附件类型
        "name": "身份证国徽面", //文件名
        "path": "/file/id_reverse/3241234351235.jpg" //文件路径
      }
    ] //附件数组
  } //请求参数
}

• 新增合作社

{
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "param": {
    "code": "V76366194", //供方编码
    "fullName": "卢军", //供方全称
    "shortName": "", //供方简称
    "classify": "artel", //供方类型: person-个人, artel-合作社, collective-村集体, company-公司
    "detail": {
      "vendorCode": "V76366194", //供方编码
      "classify": "production", //合作社类型: produce-生产, distribute-流通, serve-服务
      "unifySocialCreditCode": "9135052155323005XL", //统一社会信用代码
      "phone": "010-66261242", //联系电话
      "fax": "+86+010+26737", //传真
      "address": "贵州省 黔东南苗族侗族自治州", //地址
      "email": "j.ghh@163.com", //电子邮箱，比如 example@qq.com
      "legalPerson": "赖丽", //法人
      "legalPersonIdType": "id", //法人证件类型
      "legalPersonIdNumber": "011021199309099132" //法人证件号码
    }, //合作社
    "contacts": [
      {
        "vendorCode": "V76366194", //供方编码
        "linkman": "何明", //联系人
        "linkmanPhone": "17212344321", //联系电话
        "linkmanIdType": "id", //联系人证件类型
        "linkmanIdNumber": "412728199209029211", //联系人证件号码
        "linkmanAddress": "云南省 文山壮族苗族自治州" //地址
      }
    ], //联系方式
    "attachments": [
      {
        "vendorCode": "V76366194", //供方编码
        "attachmentClassify": "id_front", //附件类型
        "name": "身份证国徽面", //文件名
        "path": "/file/id_front/3241234351235.jpg" //文件路径
      },
      {
        "vendorCode": "V76366194", //供方编码
        "attachmentClassify": "id_reverse", //附件类型
        "name": "身份证国徽面", //文件名
        "path": "/file/id_reverse/3241234351235.jpg" //文件路径
      }
    ] //附件数组
  } //请求参数
}

• 新增公司

{
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "param": {
    "code": "V76366194", //供方编码
    "fullName": "卢军", //供方全称
    "shortName": "", //供方简称
    "classify": "company", //供方类型: person-个人, artel-合作社, collective-村集体, company-公司
    "detail": {
      "vendorCode": "V76366194", //供方编码
      "classify": "unlimited/limited/both/share_limited/share_both", //公司类型: unlimited-无限, limited-有限, both-两合,
      // share-limited-股份有限, share-both-股份两合
      "unifySocialCreditCode": "9135052155323005XL", //统一社会信用代码
      "registeredCapital": 1000.91, //注册资本
      "registeredCapitalUnit": "WY", //资本单位
      "phone": "010-66261242", //联系电话
      "fax": "+86+010+26737", //传真
      "address": "内蒙古自治区 通辽市", //地址
      "email": "x.vthz@163.com", //电子邮箱，比如 example@qq.com
      "legalPerson": "贺敏", //法人
      "legalPersonIdType": "id", //法人证件类型
      "legalPersonIdNumber": "021021199309099132" //法人证件号码
    }, //公司
    "contacts": [
      {
        "vendorCode": "V76366194", //供方编码
        "linkman": "何明", //联系人
        "linkmanPhone": "17212344321", //联系电话
        "linkmanIdType": "id", //联系人证件类型
        "linkmanIdNumber": "412728199209029211", //联系人证件号码
        "linkmanAddress": "云南省 文山壮族苗族自治州" //地址
      }
    ], //联系方式
    "attachments": [
      {
        "vendorCode": "V76366194", //供方编码
        "attachmentClassify": "id_front", //附件类型
        "name": "身份证国徽面", //文件名
        "path": "/file/id_front/3241234351235.jpg" //文件路径
      },
      {
        "vendorCode": "V76366194", //供方编码
        "attachmentClassify": "id_reverse", //附件类型
        "name": "身份证国徽面", //文件名
        "path": "/file/id_reverse/3241234351235.jpg" //文件路径
      }
    ] //附件数组
  } //请求参数
}

• 字段描述

参数名	示例值	参数类型	是否必填	参数描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	是	请求 uuid
param	{}	Object	是	请求参数
param.code	V76366194	String	是	供方编码
param.fullName	卢军	String	是	供方全称
param.shortName	-	Object	否	供方简称
param.classify	person/artel/collective/company	String	是	供方类型: person-个人, artel-合作社, collective-村集体, company-公司
param.detail(person)	{}	Object	是	个人
param.detail(person).vendorCode	V76366194	String	是	供方编码
param.detail(person).idType	id	String	是	证件类型
param.detail(person).idNumber	412825199109099121	String	是	证件号码
param.detail(person).phone	15100001232	String	是	联系电话
param.detail(person).address	商洛市	String	否	地址
param.detail(person).email	c.wkceafo@163.com	String	否	电子邮箱，比如 example@qq.com
param.detail(artel)	{}	Object	是	合作社
param.detail(artel).vendorCode	V76366194	String	是	供方编码
param.detail(artel).classify	produce	String	否	合作社类型: produce-生产, distribute-流通, serve-服务
param.detail(artel).unifySocialCreditCode	9135052155323005XL	String	是	统一社会信用代码
param.detail(artel).phone	010-66261242	String	是	联系电话
param.detail(artel).fax	+86+010+26737	String	否	传真
param.detail(artel).address	贵州省 黔东南苗族侗族自治州	String	否	地址
param.detail(artel).email	j.ghh@163.com	String	否	电子邮箱，比如 example@qq.com
param.detail(artel).legalPerson	赖丽	String	否	法人
param.detail(artel).legalPersonIdType	id	String	否	法人证件类型
param.detail(artel).legalPersonIdNumber	011021199309099132	String	否	法人证件号码
param.detail(collective)	{}	Object	是	村集体
param.detail(collective).vendorCode	V76366194	String	是	供方编码
param.detail(collective).unifySocialCreditCode	9135052155323005XL	String	是	统一社会信用代码
param.detail(collective).phone	010-66261242	String	是	联系电话
param.detail(collective).fax	+86+010+26737	String	否	传真
param.detail(collective).address	吉林省 吉林市	String	否	地址
param.detail(collective).email	q.wawhaikpwd@163.com	String	否	电子邮箱，比如 example@qq.com
param.detail(collective).legalPerson	马敏	String	否	法人
param.detail(collective).legalPersonIdType	id	String	否	法人证件类型
param.detail(collective).legalPersonIdNumber	021021199309099132	String	否	法人证件号码
param.detail(company)	{}	Object	是	公司
param.detail(company).vendorCode	V76366194	String	是	供方编码
param.detail(company).classify	unlimited/limited/both/share_limited/share_both	String	是	公司类型: unlimited-无限, limited-有限, both-两合, share-limited-股份有限, share-both-股份两合
param.detail(company).unifySocialCreditCode	9135052155323005XL	String	是	统一社会信用代码
param.detail(company).registeredCapital	1000.91	Number	是	注册资本
param.detail(company).registeredCapitalUnit	WY	String	是	资本单位
param.detail(company).phone	010-66261242	String	是	联系电话
param.detail(company).fax	+86+010+26737	String	是	传真
param.detail(company).address	内蒙古自治区 通辽市	String	是	地址
param.detail(company).email	x.vthz@163.com	String	是	电子邮箱，比如 example@qq.com
param.detail(company).legalPerson	贺敏	String	是	法人
param.detail(company).legalPersonIdType	id	String	是	法人证件类型
param.detail(company).legalPersonIdNumber	021021199309099132	String	是	法人证件号码
param.contacts	{}	Object	是	联系方式
param.contacts.vendorCode	V76366194	String	是	供方编码
param.contacts.linkman	何明	String	是	联系人
param.contacts.linkmanPhone	17212344321	String	是	联系电话
param.contacts.linkmanIdType	id	String	是	联系人证件类型
param.contacts.linkmanIdNumber	412728199209029211	String	是	联系人证件号码
param.contacts.linkmanAddress	云南省 文山壮族苗族自治州	String	是	地址
param.attachments	{}	Object	是	附件数组
param.attachments.vendorCode	V76366194	String	是	供方编码
param.attachments.attachmentClassify	id_front	String	是	附件类型
param.attachments.name	身份证国徽面	String	是	文件名
param.attachments.path	/file/id_front/3241234351235.jpg	String	是	文件路径

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200, //响应成功代码
  "msg": "添加供方成功!", //返回文字描述
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
    "data": {
      "id": 3592 //供方主键id
    } //返回数据
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功代码
msg	添加供方成功!	String	响应消息
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据对象
data.id	3592	Integer	供方主键 id

• 失败响应示例

{
  "code": 500,
  "msg": "添加供方失败!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {}
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	添加供方失败!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据

修改供方

基本信息

接口状态：未开始
接口 URI: /api/vendor
请求方式：PUT
Content-Type: application/json

请求参数

• Body 参数及说明

• 修改个人

{
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "param": {
    "id": 3592, //供方主键id
    "code": "V76366194", //供方编码
    "fullName": "卢军", //供方全称
    "shortName": "", //供方简称
    "classify": "person", //供方类型: person-个人, artel-合作社, collective-村集体, company-公司
    "detail": {
      "id": 38457, //个人供方主键id
      "vendorCode": "V76366194", //供方编码
      "idType": "id", //证件类型
      "idNumber": "412825199109099121", //证件号码
      "phone": "15100001232", //联系电话
      "address": "商洛市", //地址
      "email": "c.wkceafo@163.com" //电子邮箱，比如 example@qq.com
    }, //个人
    "contacts": [
      {
        "id": 50396, //供方联系方式主键id
        "vendorCode": "V76366194", //供方编码
        "linkman": "何明", //联系人
        "linkmanPhone": "17212344321", //联系电话
        "linkmanIdType": "id", //联系人证件类型
        "linkmanIdNumber": "412728199209029211", //联系人证件号码
        "linkmanAddress": "云南省 文山壮族苗族自治州" //地址
      }
    ], //联系方式
    "attachments": [
      {
        "vendorCode": "V76366194", //供方编码
        "attachmentClassify": "id_front", //附件类型
        "name": "身份证国徽面", //文件名
        "path": "/file/id_front/3241234351235.jpg" //文件路径
      },
      {
        "vendorCode": "V76366194", //供方编码
        "attachmentClassify": "id_reverse", //附件类型
        "name": "身份证国徽面", //文件名
        "path": "/file/id_reverse/3241234351235.jpg" //文件路径
      }
    ] //附件数组
  } //请求参数
}

• 修改集体

{
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "param": {
    "id": 3592, //供方主键id
    "code": "V76366194", //供方编码
    "fullName": "卢军", //供方全称
    "shortName": "", //供方简称
    "classify": "collective", //供方类型: person-个人, artel-合作社, collective-村集体, company-公司
    "detail": {
      "id": 71639, //村集体供方主键id
      "vendorCode": "V76366194", //供方编码
      "unifySocialCreditCode": "9135052155323005XL", //统一社会信用代码
      "phone": "010-66261242", //联系电话
      "fax": "+86+010+26737", //传真
      "address": "吉林省 吉林市", //地址
      "email": "q.wawhaikpwd@163.com", //电子邮箱，比如 example@qq.com
      "legalPerson": "马敏", //法人
      "legalPersonIdType": "id", //法人证件类型
      "legalPersonIdNumber": "021021199309099132" //法人证件号码
    }, //村集体
    "contacts": [
      {
        "id": 50396, //供方联系方式主键id
        "vendorCode": "V76366194", //供方编码
        "linkman": "何明", //联系人
        "linkmanPhone": "17212344321", //联系电话
        "linkmanIdType": "id", //联系人证件类型
        "linkmanIdNumber": "412728199209029211", //联系人证件号码
        "linkmanAddress": "云南省 文山壮族苗族自治州" //地址
      }
    ], //联系方式
    "attachments": [
      {
        "vendorCode": "V76366194", //供方编码
        "attachmentClassify": "id_front", //附件类型
        "name": "身份证国徽面", //文件名
        "path": "/file/id_front/3241234351235.jpg" //文件路径
      },
      {
        "vendorCode": "V76366194", //供方编码
        "attachmentClassify": "id_reverse", //附件类型
        "name": "身份证国徽面", //文件名
        "path": "/file/id_reverse/3241234351235.jpg" //文件路径
      }
    ] //附件数组
  } //请求参数
}

• 修改合作社

{
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "param": {
    "id": 3592, //供方主键id
    "code": "V76366194", //交易中心编码
    "fullName": "卢军", //供方全称
    "shortName": "", //供方简称
    "classify": "artel", //供方类型: person-个人, artel-合作社, collective-村集体, company-公司
    "detail": {
      "id": 55238, //合作社供方主键id
      "vendorCode": "V76366194", //供方编码
      "classify": "production", //合作社类型: produce-生产, distribute-流通, serve-服务
      "unifySocialCreditCode": "9135052155323005XL", //统一社会信用代码
      "phone": "010-66261242", //联系电话
      "fax": "+86+010+26737", //传真
      "address": "贵州省 黔东南苗族侗族自治州", //地址
      "email": "j.ghh@163.com", //电子邮箱，比如 example@qq.com
      "legalPerson": "赖丽", //法人
      "legalPersonIdType": "id", //法人证件类型
      "legalPersonIdNumber": "011021199309099132" //法人证件号码
    }, //合作社
    "contacts": [
      {
        "id": 50396, //供方联系方式主键id
        "vendorCode": "V76366194", //供方编码
        "linkman": "何明", //联系人
        "linkmanPhone": "17212344321", //联系电话
        "linkmanIdType": "id", //联系人证件类型
        "linkmanIdNumber": "412728199209029211", //联系人证件号码
        "linkmanAddress": "云南省 文山壮族苗族自治州" //地址
      }
    ], //联系方式
    "attachments": [
      {
        "vendorCode": "V76366194", //供方编码
        "attachmentClassify": "id_front", //附件类型
        "name": "身份证国徽面", //文件名
        "path": "/file/id_front/3241234351235.jpg" //文件路径
      },
      {
        "vendorCode": "V76366194", //供方编码
        "attachmentClassify": "id_reverse", //附件类型
        "name": "身份证国徽面", //文件名
        "path": "/file/id_reverse/3241234351235.jpg" //文件路径
      }
    ] //附件数组
  } //请求参数
}

• 新增公司

{
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "param": {
    "id": 3592, //供方主键id
    "code": "V76366194", //交易中心编码
    "fullName": "卢军", //供方全称
    "shortName": "", //供方简称
    "classify": "company", //供方类型: person-个人, artel-合作社, collective-村集体, company-公司
    "detail": {
      "id": 66452, //公司供方主键id
      "vendorCode": "V76366194", //供方编码
      "classify": "unlimited/limited/both/share_limited/share_both", //公司类型: unlimited-无限, limited-有限, both-两合,
      // share-limited-股份有限, share-both-股份两合
      "unifySocialCreditCode": "9135052155323005XL", //统一社会信用代码
      "registeredCapital": 1000.91, //注册资本
      "registeredCapitalUnit": "WY", //资本单位
      "phone": "010-66261242", //联系电话
      "fax": "+86+010+26737", //传真
      "address": "内蒙古自治区 通辽市", //地址
      "email": "x.vthz@163.com", //电子邮箱，比如 example@qq.com
      "legalPerson": "贺敏", //法人
      "legalPersonIdType": "id", //法人证件类型
      "legalPersonIdNumber": "021021199309099132" //法人证件号码
    }, //公司
    "contacts": [
      {
        "id": 50396, //供方联系方式主键id
        "vendorCode": "V76366194", //供方编码
        "linkman": "何明", //联系人
        "linkmanPhone": "17212344321", //联系电话
        "linkmanIdType": "id", //联系人证件类型
        "linkmanIdNumber": "412728199209029211", //联系人证件号码
        "linkmanAddress": "云南省 文山壮族苗族自治州" //地址
      }
    ], //联系方式
    "attachments": [
      {
        "vendorCode": "V76366194", //供方编码
        "attachmentClassify": "id_front", //附件类型
        "name": "身份证国徽面", //文件名
        "path": "/file/id_front/3241234351235.jpg" //文件路径
      },
      {
        "vendorCode": "V76366194", //供方编码
        "attachmentClassify": "id_reverse", //附件类型
        "name": "身份证国徽面", //文件名
        "path": "/file/id_reverse/3241234351235.jpg" //文件路径
      }
    ] //附件数组
  } //请求参数
}

• 字段描述

参数名	示例值	参数类型	是否必填	参数描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	是	请求 uuid
param	{}	Object	是	请求参数
param.id	3592	Integer	是	供方主键 id
param.code	V76366194	String	是	供方编码
param.fullName	卢军	String	是	供方全称
param.shortName	-	Object	否	供方简称
param.classify	person/artel/collective/company	String	是	供方类型: person-个人, artel-合作社, collective-村集体, company-公司
param.detail(person)	{}	Object	是	个人
param.detail(person).id	38457	Integer	否	个人供方主键 id
param.detail(person).vendorCode	V76366194	String	是	供方编码
param.detail(person).idType	id	String	是	证件类型
param.detail(person).idNumber	412825199109099121	String	是	证件号码
param.detail(person).phone	15100001232	String	是	联系电话
param.detail(person).address	商洛市	String	否	地址
param.detail(person).email	c.wkceafo@163.com	String	否	电子邮箱，比如 example@qq.com
param.detail(artel)	{}	Object	是	合作社
param.detail(artel).id	55238	Integer	否	合作社供方主键 id
param.detail(artel).vendorCode	V76366194	String	是	供方编码
param.detail(artel).classify	produce	String	否	合作社类型: produce-生产, distribute-流通, serve-服务
param.detail(artel).unifySocialCreditCode	9135052155323005XL	String	是	统一社会信用代码
param.detail(artel).phone	010-66261242	String	是	联系电话
param.detail(artel).fax	+86+010+26737	String	否	传真
param.detail(artel).address	贵州省 黔东南苗族侗族自治州	String	否	地址
param.detail(artel).email	j.ghh@163.com	String	否	电子邮箱，比如 example@qq.com
param.detail(artel).legalPerson	赖丽	String	否	法人
param.detail(artel).legalPersonIdType	id	String	否	法人证件类型
param.detail(artel).legalPersonIdNumber	011021199309099132	String	否	法人证件号码
param.detail(collective)	{}	Object	是	村集体
param.detail(collective).id	71639	Integer	否	村集体供方主键 id
param.detail(collective).vendorCode	V76366194	String	是	供方编码
param.detail(collective).unifySocialCreditCode	9135052155323005XL	String	是	统一社会信用代码
param.detail(collective).phone	010-66261242	String	是	联系电话
param.detail(collective).fax	+86+010+26737	String	否	传真
param.detail(collective).address	吉林省 吉林市	String	否	地址
param.detail(collective).email	q.wawhaikpwd@163.com	String	否	电子邮箱，比如 example@qq.com
param.detail(collective).legalPerson	马敏	String	否	法人
param.detail(collective).legalPersonIdType	id	String	否	法人证件类型
param.detail(collective).legalPersonIdNumber	021021199309099132	String	否	法人证件号码
param.detail(company)	{}	Object	是	公司
param.detail(company).id	66452	Integer	否	公司供方主键 id
param.detail(company).vendorCode	V76366194	String	是	供方编码
param.detail(company).classify	unlimited/limited/both/share_limited/share_both	String	是	公司类型: unlimited-无限, limited-有限, both-两合, share-limited-股份有限, share-both-股份两合
param.detail(company).unifySocialCreditCode	9135052155323005XL	String	是	统一社会信用代码
param.detail(company).registeredCapital	1000.91	Number	是	注册资本
param.detail(company).registeredCapitalUnit	WY	String	是	资本单位
param.detail(company).phone	010-66261242	String	是	联系电话
param.detail(company).fax	+86+010+26737	String	是	传真
param.detail(company).address	内蒙古自治区 通辽市	String	是	地址
param.detail(company).email	x.vthz@163.com	String	是	电子邮箱，比如 example@qq.com
param.detail(company).legalPerson	贺敏	String	是	法人
param.detail(company).legalPersonIdType	id	String	是	法人证件类型
param.detail(company).legalPersonIdNumber	021021199309099132	String	是	法人证件号码
param.contacts	{}	Object	是	联系方式
param.contacts.id	50396	Integer	否	供方联系方式主键 id
param.contacts.vendorCode	V76366194	String	是	供方编码
param.contacts.linkman	何明	String	是	联系人
param.contacts.linkmanPhone	17212344321	String	是	联系电话
param.contacts.linkmanIdType	id	String	是	联系人证件类型
param.contacts.linkmanIdNumber	412728199209029211	String	是	联系人证件号码
param.contacts.linkmanAddress	云南省 文山壮族苗族自治州	String	是	地址
param.attachments	{}	Object	是	附件数组
param.attachments.vendorCode	V76366194	String	是	供方编码
param.attachments.attachmentClassify	id_front	String	是	附件类型
param.attachments.name	身份证国徽面	String	是	文件名
param.attachments.path	/file/id_front/3241234351235.jpg	String	是	文件路径

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200, //响应成功状态码
  "msg": "修改供方成功!", //返回文字描述
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "data": {
    "id": 3592 //供方主键id
  } //返回数据
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功代码
msg	修改供方成功!	String	响应消息
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据对象
data.id	3592	Integer	供方主键 id

• 失败响应示例

{
  "code": 500,
  "msg": "修改供方失败!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {}
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	修改供方失败!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据
data.id	712	Integer	交易中心主键 id

删除供方

基本信息

接口状态：未开始
接口 URI: /api/vendor/:uuid/:id/:code
请求方式：DELETE
Content-Type: application/json

请求参数

• 路径参数及说明

参数名	示例值	参数类型	是否必填	参数描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	是	请求 uuid
id	3592	Integer	是	供方主键 id
code	V76366194	String	是	供方编码

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200, //响应成功状态码
  "msg": "删除供方成功!", //返回文字描述
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "data": {
    "id": 3592 //供方主键id
  } //返回数据
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功代码
msg	删除供方成功!	String	响应消息
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据对象
data.id	3592	Integer	供方主键 id

• 失败响应示例

{
  "code": 500,
  "msg": "删除供方失败!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {}
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	删除供方失败!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据

标的管理

查询标的列表

基本信息

接口状态：未开始
接口 URI: /api/subject?uuid=2Ba7C78d-77Ff-e25b-183B-eF8795509bdd&page=1&limit=10&name=村集体
请求方式：GET
Content-Type: application/json

请求参数

• Query 参数及说明

参数名	示例值	参数类型	是否必填	参数描述
uuid	2Ba7C78d-77Ff-e25b-183B-eF8795509bdd	String	是	请求 uuid
page	1	Integer	是	页码
limit	10	Integer	是	每页数据量
name	土地	String	否	标的名称
classify	land	String	否	标的类型

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200, //响应成功状态码
  "msg": "查询成功!", //返回文字描述
  "uuid": "2Ba7C78d-77Ff-e25b-183B-eF8795509bdd", //请求uuid
  "data": {
    "total": 7, //标的总数据量
    "subjects": [
      {
        "id": 1, //标的主键id
        "code": "S424348", //标的编码
        "name": "董家村23.5亩土地", //标的名称
        "classify": "land", //标的类型
        "rightsType": "use" //标的权利类型
      },
      {
        "id": 822, //标的主键id
        "code": "S681348", //标的编码
        "name": "宜都村160平方米建设用地", //标的名称
        "classify": "land", //标的类型
        "rightsType": "use" //标的权利类型
      },
      {
        "id": 10, //标的主键id
        "code": "S555986", //标的编码
        "name": "梧中村80亩荒山", //标的名称
        "classify": "land", //标的类型
        "rightsType": "use" //标的权利类型
      },
      {
        "id": 460, //标的主键id
        "code": "S252559", //标的编码
        "name": "东兴村90平方米商铺", //标的名称
        "classify": "building", //标的类型
        "rightsType": "use" //标的权利类型
      },
      {
        "id": 452, //标的主键id
        "code": "S115075", //标的编码
        "name": "史家村5台拖拉机", //标的名称
        "classify": "equipment", //标的类型
        "rightsType": "ownership" //标的权利类型
      },
      {
        "id": 341, //标的主键id
        "code": "S650748", //标的编码
        "name": "宋家村灌溉水泵", //标的名称
        "classify": "facility", //标的类型
        "rightsType": "use" //标的权利类型
      },
      {
        "id": 178, //标的主键id
        "code": "S487855", //标的编码
        "name": "宋家村280亩林地", //标的名称
        "classify": "forest", //标的类型
        "rightsType": "use" //标的权利类型
      }
    ] //标的数组
  } //返回数据
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功代码
msg	查询成功!	String	响应消息
uuid	2Ba7C78d-77Ff-e25b-183B-eF8795509bdd	String	请求 uuid
data	{}	Object	返回数据对象
data.total	7	Integer	总数据量
data.subjects	{}	Object	标的数组
data.subjects.id	1	Integer	标的主键 id
data.subjects.code	S424348	String	标的编码
data.subjects.name	董家村 23.5 亩土地	String	标的名称
data.subjects.classify	land	String	标的类型
data.subjects.rightsType	use	String	标的权利类型

• 失败响应示例

{
  "code": 500,
  "msg": "查询失败!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {}
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	查询失败!	String	响应消息
uuid	2Ba7C78d-77Ff-e25b-183B-eF8795509bdd	String	请求 uuid
data	{}	Object	返回数据对象

新增标的

基本信息

接口状态：未开始
接口 URI: /api/subject
请求方式：POST
Content-Type: application/json

请求参数

• Body 参数及说明

• 新增土地

{
  "uuid": "2Ba7C78d-77Ff-e25b-183B-eF8795509bdd", //请求uuid
  "param": {
    "vendorCode": "V76366194", //供方编码
    "code": "S424348", //标的编码
    "name": "董家村23.5亩土地", //标的名称
    "classify": "land", //标的类型
    "rightsType": "use", //标的权利
    "detail": {
      "subjectCode": "S424348", //标的编码
      "classify": "012", //土地类型
      "acreage": 23.5, //面积
      "acreage_unit": "mu", //面积单位
      "shapeRule": "Y", //是否规则形状: Y-是, N-否
      "east": "马滩水电站进水河", //东至
      "south": "农田灌溉水渠", //南至
      "west": "袁河车田段", //西至
      "north": "车田村道", //北至
      "shape_desc": "", //不规则形状描述
      "purpose": "用途", //土地用途
      "location": "宁夏回族自治区 固原市", //坐落位置
      "attachment": "地上附着物", //地上附着物说明
      "desc": "描述" //其他说明
    }, //土地
    "attachments": [
      {
        "subjectCode": "S424348", //标的编码
        "attachmentClassify": "subject_show", //附件类型
        "name": "标的展示图1", //附件名
        "path": "/file/subject_show/3241234351235.jpg" //附件路径
      },
      {
        "subjectCode": "S424348", //标的编码
        "attachmentClassify": "subject_show", //附件类型
        "name": "标的展示图2", //附件名
        "path": "/file/subject_show/3241234351235.jpg" //附件路径
      }
    ] //标的附件
  } //请求参数
}

• 新增房屋建筑

{
  "uuid": "2Ba7C78d-77Ff-e25b-183B-eF8795509bdd", //请求uuid
  "param": {
    "vendorCode": "V76366194", //供方编码
    "code": "S424348", //标的编码
    "name": "董家村23.5亩土地", //标的名称
    "classify": "land", //标的类型
    "rightsType": "use", //标的权利
    "detail": {
      "subjectCode": "S252559", //标的编码
      "classify": "商铺", //类型
      "location": "河南省 许昌市", //坐落位置
      "buildTime": "2013-11-12", //构建时间
      "buildingArea": 90, //建筑面积
      "registerBuildingArea": 90, //产证注册面积
      "areaUnit": "平方米", //面积单位
      "purpose": "用途", //用途
      "originalValue": 15, //原值
      "depreciatedValue": 4, //已提折旧
      "residualValue": 11, //预计净残值
      "valueUnit": "万元", //价值单位
      "chargePerson": "袁涛", //负责人
      "desc": "描述" //其他描述说明
    }, //房屋建筑
    "attachments": [
      {
        "subjectCode": "S424348", //标的编码
        "attachmentClassify": "subject_show", //附件类型
        "name": "标的展示图1", //附件名
        "path": "/file/subject_show/3241234351235.jpg" //附件路径
      },
      {
        "subjectCode": "S424348", //标的编码
        "attachmentClassify": "subject_show", //附件类型
        "name": "标的展示图2", //附件名
        "path": "/file/subject_show/3241234351235.jpg" //附件路径
      }
    ] //标的附件
  } //请求参数
}

• 新增设施

{
  "uuid": "2Ba7C78d-77Ff-e25b-183B-eF8795509bdd", //请求uuid
  "param": {
    "vendorCode": "V76366194", //供方编码
    "code": "S424348", //标的编码
    "name": "董家村23.5亩土地", //标的名称
    "classify": "land", //标的类型
    "rightsType": "use", //标的权利
    "detail": {
      "subjectCode": "S650748", //标的编码
      "classify": "水泵", //设施类型
      "buildTime": "2013-11-12", //构建时间
      "quantity": 4, //数量
      "quantityUnit": "台", //计量单位
      "location": "四川省 阿坝藏族羌族自治州", //坐落位置
      "desc": "描述" //其他说明
    }, //设施
    "attachments": [
      {
        "subjectCode": "S424348", //标的编码
        "attachmentClassify": "subject_show", //附件类型
        "name": "标的展示图1", //附件名
        "path": "/file/subject_show/3241234351235.jpg" //附件路径
      },
      {
        "subjectCode": "S424348", //标的编码
        "attachmentClassify": "subject_show", //附件类型
        "name": "标的展示图2", //附件名
        "path": "/file/subject_show/3241234351235.jpg" //附件路径
      }
    ] //标的附件
  } //请求参数
}

• 新增设备

{
  "uuid": "2Ba7C78d-77Ff-e25b-183B-eF8795509bdd", //请求uuid
  "param": {
    "vendorCode": "V76366194", //供方编码
    "code": "S424348", //标的编码
    "name": "董家村23.5亩土地", //标的名称
    "classify": "land", //标的类型
    "rightsType": "use", //标的权利
    "detail": {
      "subjectCode": "S115075", //标的编码
      "classify": "农用机械", //设备类型
      "location": "四川省 阿坝藏族羌族自治州", //坐落位置
      "specification": "规格型号", //规格型号
      "manufacturer": "生产厂家", //生产厂家
      "purchaseTime": "1999-04-08", //购建时间
      "quantity": 2, //数量
      "quantityUnit": "台", //计量单位
      "originalValue": 8, //原值
      "depreciatedValue": 3, //已提折旧
      "residualValue": 5, //预计净残值
      "valueUnit": "万元", //价值单位
      "chargePerson": "孔静", //责任人
      "desc": "描述" //其他描述说明
    }, //设备
    "attachments": [
      {
        "subjectCode": "S424348", //标的编码
        "attachmentClassify": "subject_show", //附件类型
        "name": "标的展示图1", //附件名
        "path": "/file/subject_show/3241234351235.jpg" //附件路径
      },
      {
        "subjectCode": "S424348", //标的编码
        "attachmentClassify": "subject_show", //附件类型
        "name": "标的展示图2", //附件名
        "path": "/file/subject_show/3241234351235.jpg" //附件路径
      }
    ] //标的附件
  } //请求参数
}

• 新增林权

{
  "uuid": "2Ba7C78d-77Ff-e25b-183B-eF8795509bdd", //请求uuid
  "param": {
    "vendorCode": "V76366194", //供方编码
    "code": "S424348", //标的编码
    "name": "董家村23.5亩土地", //标的名称
    "classify": "land", //标的类型
    "rightsType": "use", //标的权利
    "detail": {
      "subjectCode": "S487855", //标的编码
      "location": "位置", //坐落位置
      "acreage": 280, //面积
      "acreageUnit": "亩", //面积单位
      "shapeRule": "Y", //是否规则
      "east": "农田", //东至
      "south": "山脊", //南至
      "west": "农田", //西至
      "north": "山脊", //北至
      "shapeDesc": "形状描述", //不规则形状描述说明
      "purpose": "用途", //用途
      "classify": "031", //林地类型
      "forestRightsCode": "2022-001", //林权证编号
      "fellLicenseCode": "34032202190201002", //林木采伐许可证编号
      "treeType": "杉木", //主要树种
      "treeOrigin": "天然林", //林木起源
      "treeAmount": 280, //林木数量
      "amountUnit": "棵", //计量单位
      "averageTreeHeight": 9, //平均树高
      "heightUnit": "米", //树高单位
      "averageTreeDiameter": 12, //平均胸径
      "diameterUnit": "厘米", //胸径单位
      "treeAccumulation": 360, //蓄积
      "accumulationUnit": "方", //蓄积单位
      "treeVolume": 300, //材积
      "volumeUnit": "方", //材积单位
      "desc": "描述" //其他描述说明
    }, //林权
    "attachments": [
      {
        "subjectCode": "S424348", //标的编码
        "attachmentClassify": "subject_show", //附件类型
        "name": "标的展示图1", //附件名
        "path": "/file/subject_show/3241234351235.jpg" //附件路径
      },
      {
        "subjectCode": "S424348", //标的编码
        "attachmentClassify": "subject_show", //附件类型
        "name": "标的展示图2", //附件名
        "path": "/file/subject_show/3241234351235.jpg" //附件路径
      }
    ] //标的附件
  } //请求参数
}

• 字段描述

参数名	示例值	参数类型	是否必填	参数描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	是	请求 uuid
param	{}	Object	是	请求参数
param.vendorCode	V76366194	String	是	供方编码
param.code	S424348	String	是	标的编码
param.name	董家村 23.5 亩土地	String	是	标的名称
param.classify	land	String	是	标的类型
param.rightsType	use	String	是	标的权利
param.detail(land)	{}	Object	否	土地
param.detail(land).subjectCode	S424348	String	否	标的编码
param.detail(land).classify	012	String	否	土地类型
param.detail(land).acreage	23.5	Number	否	面积
param.detail(land).acreage_unit	mu	String	否	面积单位
param.detail(land).shapeRule	Y	String	否	是否规则形状: Y-是, N-否
param.detail(land).east	马滩水电站进水河	String	否	东至
param.detail(land).south	农田灌溉水渠	String	否	南至
param.detail(land).west	袁河车田段	String	否	西至
param.detail(land).north	车田村道	String	否	北至
param.detail(land).shape_desc	-	Object	否	不规则形状描述
param.detail(land).purpose	用途	String	否	土地用途
param.detail(land).location	宁夏回族自治区 固原市	String	否	坐落位置
param.detail(land).attachment	地上附着物	String	否	地上附着物说明
param.detail(land).desc	描述	String	否	其他说明
param.detail(building)	{}	Object	否	房屋建筑
param.detail(building).subjectCode	S252559	String	否	标的编码
param.detail(building).classify	商铺	String	否	类型
param.detail(building).location	河南省 许昌市	String	否	坐落位置
param.detail(building).buildTime	2013-11-12	String	否	构建时间
param.detail(building).buildingArea	90	Number	否	建筑面积
param.detail(building).registerBuildingArea	90	Number	否	产证注册面积
param.detail(building).areaUnit	平方米	String	否	面积单位
param.detail(building).purpose	用途	String	否	用途
param.detail(building).originalValue	15	Number	否	原值
param.detail(building).depreciatedValue	4	Number	否	已提折旧
param.detail(building).residualValue	11	Number	否	预计净残值
param.detail(building).valueUnit	万元	String	否	价值单位
param.detail(building).chargePerson	袁涛	String	否	负责人
param.detail(building).desc	描述	String	否	其他描述说明
param.detail(facility)	{}	Object	否	设施
param.detail(facility).subjectCode	S650748	String	否	标的编码
param.detail(facility).classify	水泵	String	否	设施类型
param.detail(facility).buildTime	2013-11-12	String	否	构建时间
param.detail(facility).quantity	4	Integer	否	数量
param.detail(facility).quantityUnit	台	String	否	计量单位
param.detail(facility).location	四川省 阿坝藏族羌族自治州	String	否	坐落位置
param.detail(facility).desc	描述	String	否	其他说明
param.detail(equipment)	{}	Object	否	设备
param.detail(equipment).subjectCode	S115075	String	否	标的编码
param.detail(equipment).classify	农用机械	String	否	设备类型
param.detail(equipment).location	四川省 阿坝藏族羌族自治州	String	否	坐落位置
param.detail(equipment).specification	规格型号	String	否	规格型号
param.detail(equipment).manufacturer	生产厂家	String	否	生产厂家
param.detail(equipment).purchaseTime	1999-04-08	String	否	购建时间
param.detail(equipment).quantity	2	Number	否	数量
param.detail(equipment).quantityUnit	台	String	否	计量单位
param.detail(equipment).originalValue	8	Number	否	原值
param.detail(equipment).depreciatedValue	3	Number	否	已提折旧
param.detail(equipment).residualValue	5	Number	否	预计净残值
param.detail(equipment).valueUnit	万元	String	否	价值单位
param.detail(equipment).chargePerson	孔静	String	否	责任人
param.detail(equipment).desc	描述	String	否	其他描述说明
param.detail(forest)	{}	Object	否	林权
param.detail(forest).subjectCode	S487855	String	否	标的编码
param.detail(forest).location	位置	String	否	坐落位置
param.detail(forest).acreage	280	Number	否	面积
param.detail(forest).acreageUnit	亩	String	否	面积单位
param.detail(forest).shapeRule	Y	String	否	是否规则
param.detail(forest).east	农田	String	否	东至
param.detail(forest).south	山脊	String	否	南至
param.detail(forest).west	农田	String	否	西至
param.detail(forest).north	山脊	String	否	北至
param.detail(forest).shapeDesc	形状描述	String	否	不规则形状描述说明
param.detail(forest).purpose	用途	String	否	用途
param.detail(forest).classify	031	String	否	林地类型
param.detail(forest).forestRightsCode	2022-001	String	否	林权证编号
param.detail(forest).fellLicenseCode	34032202190201002	String	否	林木采伐许可证编号
param.detail(forest).treeType	杉木	String	否	主要树种
param.detail(forest).treeOrigin	天然林	String	否	林木起源
param.detail(forest).treeAmount	280	Integer	否	林木数量
param.detail(forest).amountUnit	棵	String	否	计量单位
param.detail(forest).averageTreeHeight	9	Number	否	平均树高
param.detail(forest).heightUnit	米	String	否	树高单位
param.detail(forest).averageTreeDiameter	12	Number	否	平均胸径
param.detail(forest).diameterUnit	厘米	String	否	胸径单位
param.detail(forest).treeAccumulation	360	Number	否	蓄积
param.detail(forest).accumulationUnit	方	String	否	蓄积单位
param.detail(forest).treeVolume	300	Number	否	材积
param.detail(forest).volumeUnit	方	String	否	材积单位
param.detail(forest).desc	描述	String	否	其他描述说明
param.attachments	[]	Object	否	标的附件
param.attachments.subjectCode	S424348	String	否	标的编码
param.attachments.attachmentClassify	subject_show	String	否	附件类型
param.attachments.name	标的展示图 1	String	否	附件名
param.attachments.path	/file/subject_show/3241234351235.jpg	String	否	附件路径

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200, //响应成功状态码
  "msg": "添加标的成功!", //返回文字描述
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "data": {
    "id": 9953 //标的主键id
  } //返回数据
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功代码
msg	添加标的成功!	String	响应消息
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据对象
data.id	9953	Integer	标的主键 id

• 失败响应示例

{
  "code": 500,
  "msg": "添加标的失败!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {}
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	添加标的失败!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据

修改标的

基本信息

接口状态：未开始
接口 URI: /api/subject
请求方式：PUT
Content-Type: application/json

请求参数

• Body 参数及说明

• 修改土地

{
  "uuid": "2Ba7C78d-77Ff-e25b-183B-eF8795509bdd", //请求uuid
  "param": {
    "id": 9953, //标的主键id
    "vendorCode": "V76366194", //供方编码
    "code": "S424348", //标的编码
    "name": "董家村23.5亩土地", //标的名称
    "classify": "land", //标的类型
    "rightsType": "use", //标的权利
    "detail": {
      "id": 2105, //土地主键id
      "subjectCode": "S424348", //标的编码
      "classify": "012", //土地类型
      "acreage": 23.5, //面积
      "acreage_unit": "mu", //面积单位
      "shapeRule": "Y", //是否规则形状: Y-是, N-否
      "east": "马滩水电站进水河", //东至
      "south": "农田灌溉水渠", //南至
      "west": "袁河车田段", //西至
      "north": "车田村道", //北至
      "shape_desc": "", //不规则形状描述
      "purpose": "用途", //土地用途
      "location": "宁夏回族自治区 固原市", //坐落位置
      "attachment": "地上附着物", //地上附着物说明
      "desc": "描述" //其他说明
    }, //土地
    "attachments": [
      {
        "subjectCode": "S424348", //标的编码
        "attachmentClassify": "subject_show", //附件类型
        "name": "标的展示图1", //附件名
        "path": "/file/subject_show/3241234351235.jpg" //附件路径
      },
      {
        "subjectCode": "S424348", //标的编码
        "attachmentClassify": "subject_show", //附件类型
        "name": "标的展示图2", //附件名
        "path": "/file/subject_show/3241234351235.jpg" //附件路径
      }
    ] //标的附件
  } //请求参数
}

• 修改房屋建筑

{
  "uuid": "2Ba7C78d-77Ff-e25b-183B-eF8795509bdd", //请求uuid
  "param": {
    "id": 9953, //标的主键id
    "vendorCode": "V76366194", //供方编码
    "code": "S424348", //标的编码
    "name": "董家村23.5亩土地", //标的名称
    "classify": "land", //标的类型
    "rightsType": "use", //标的权利
    "detail": {
      "id": 8399, //房屋建筑主键id
      "subjectCode": "S252559", //标的编码
      "classify": "商铺", //类型
      "location": "河南省 许昌市", //坐落位置
      "buildTime": "2013-11-12", //构建时间
      "buildingArea": 90, //建筑面积
      "registerBuildingArea": 90, //产证注册面积
      "areaUnit": "平方米", //面积单位
      "purpose": "用途", //用途
      "originalValue": 15, //原值
      "depreciatedValue": 4, //已提折旧
      "residualValue": 11, //预计净残值
      "valueUnit": "万元", //价值单位
      "chargePerson": "袁涛", //负责人
      "desc": "描述" //其他描述说明
    }, //房屋建筑
    "attachments": [
      {
        "subjectCode": "S424348", //标的编码
        "attachmentClassify": "subject_show", //附件类型
        "name": "标的展示图1", //附件名
        "path": "/file/subject_show/3241234351235.jpg" //附件路径
      },
      {
        "subjectCode": "S424348", //标的编码
        "attachmentClassify": "subject_show", //附件类型
        "name": "标的展示图2", //附件名
        "path": "/file/subject_show/3241234351235.jpg" //附件路径
      }
    ] //标的附件
  } //请求参数
}

• 修改设施

{
  "uuid": "2Ba7C78d-77Ff-e25b-183B-eF8795509bdd", //请求uuid
  "param": {
    "id": 9953, //标的主键id
    "vendorCode": "V76366194", //供方编码
    "code": "S424348", //标的编码
    "name": "董家村23.5亩土地", //标的名称
    "classify": "land", //标的类型
    "rightsType": "use", //标的权利
    "detail": {
      "id": 8399, //设施主键id
      "subjectCode": "S650748", //标的编码
      "classify": "水泵", //设施类型
      "buildTime": "2013-11-12", //构建时间
      "quantity": 4, //数量
      "quantityUnit": "台", //计量单位
      "location": "四川省 阿坝藏族羌族自治州", //坐落位置
      "desc": "描述" //其他说明
    }, //设施
    "attachments": [
      {
        "subjectCode": "S424348", //标的编码
        "attachmentClassify": "subject_show", //附件类型
        "name": "标的展示图1", //附件名
        "path": "/file/subject_show/3241234351235.jpg" //附件路径
      },
      {
        "subjectCode": "S424348", //标的编码
        "attachmentClassify": "subject_show", //附件类型
        "name": "标的展示图2", //附件名
        "path": "/file/subject_show/3241234351235.jpg" //附件路径
      }
    ] //标的附件
  } //请求参数
}

• 修改设备

{
  "uuid": "2Ba7C78d-77Ff-e25b-183B-eF8795509bdd", //请求uuid
  "param": {
    "id": 9953, //标的主键id
    "vendorCode": "V76366194", //供方编码
    "code": "S424348", //标的编码
    "name": "董家村23.5亩土地", //标的名称
    "classify": "land", //标的类型
    "rightsType": "use", //标的权利
    "detail": {
      "id": 3885, //设备主键id
      "subjectCode": "S115075", //标的编码
      "classify": "农用机械", //设备类型
      "location": "四川省 阿坝藏族羌族自治州", //坐落位置
      "specification": "规格型号", //规格型号
      "manufacturer": "生产厂家", //生产厂家
      "purchaseTime": "1999-04-08", //购建时间
      "quantity": 2, //数量
      "quantityUnit": "台", //计量单位
      "originalValue": 8, //原值
      "depreciatedValue": 3, //已提折旧
      "residualValue": 5, //预计净残值
      "valueUnit": "万元", //价值单位
      "chargePerson": "孔静", //责任人
      "desc": "描述" //其他描述说明
    }, //设备
    "attachments": [
      {
        "subjectCode": "S424348", //标的编码
        "attachmentClassify": "subject_show", //附件类型
        "name": "标的展示图1", //附件名
        "path": "/file/subject_show/3241234351235.jpg" //附件路径
      },
      {
        "subjectCode": "S424348", //标的编码
        "attachmentClassify": "subject_show", //附件类型
        "name": "标的展示图2", //附件名
        "path": "/file/subject_show/3241234351235.jpg" //附件路径
      }
    ] //标的附件
  } //请求参数
}

• 修改林权

{
  "uuid": "2Ba7C78d-77Ff-e25b-183B-eF8795509bdd", //请求uuid
  "param": {
    "id": 9953, //标的主键id
    "vendorCode": "V76366194", //供方编码
    "code": "S424348", //标的编码
    "name": "董家村23.5亩土地", //标的名称
    "classify": "land", //标的类型
    "rightsType": "use", //标的权利
    "detail": {
      "id": 2095, //林权主键id
      "subjectCode": "S487855", //标的编码
      "location": "位置", //坐落位置
      "acreage": 280, //面积
      "acreageUnit": "亩", //面积单位
      "shapeRule": "Y", //是否规则
      "east": "农田", //东至
      "south": "山脊", //南至
      "west": "农田", //西至
      "north": "山脊", //北至
      "shapeDesc": "形状描述", //不规则形状描述说明
      "purpose": "用途", //用途
      "classify": "031", //林地类型
      "forestRightsCode": "2022-001", //林权证编号
      "fellLicenseCode": "34032202190201002", //林木采伐许可证编号
      "treeType": "杉木", //主要树种
      "treeOrigin": "天然林", //林木起源
      "treeAmount": 280, //林木数量
      "amountUnit": "棵", //计量单位
      "averageTreeHeight": 9, //平均树高
      "heightUnit": "米", //树高单位
      "averageTreeDiameter": 12, //平均胸径
      "diameterUnit": "厘米", //胸径单位
      "treeAccumulation": 360, //蓄积
      "accumulationUnit": "方", //蓄积单位
      "treeVolume": 300, //材积
      "volumeUnit": "方", //材积单位
      "desc": "描述" //其他描述说明
    }, //林权
    "attachments": [
      {
        "subjectCode": "S424348", //标的编码
        "attachmentClassify": "subject_show", //附件类型
        "name": "标的展示图1", //附件名
        "path": "/file/subject_show/3241234351235.jpg" //附件路径
      },
      {
        "subjectCode": "S424348", //标的编码
        "attachmentClassify": "subject_show", //附件类型
        "name": "标的展示图2", //附件名
        "path": "/file/subject_show/3241234351235.jpg" //附件路径
      }
    ] //标的附件
  } //请求参数
}

• 字段描述

参数名	示例值	参数类型	是否必填	参数描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	是	请求 uuid
param	{}	Object	是	请求参数
param.id	9953	Integer	是	标的主键 id
param.vendorCode	V76366194	String	是	供方编码
param.code	S424348	String	是	标的编码
param.name	董家村 23.5 亩土地	String	是	标的名称
param.classify	land	String	是	标的类型
param.rightsType	use	String	是	标的权利
param.detail(land)	{}	Object	否	土地
param.detail(land).id	2105	Integer	否	土地主键 id
param.detail(land).subjectCode	S424348	String	否	标的编码
param.detail(land).classify	012	String	否	土地类型
param.detail(land).acreage	23.5	Number	否	面积
param.detail(land).acreage_unit	mu	String	否	面积单位
param.detail(land).shapeRule	Y	String	否	是否规则形状: Y-是, N-否
param.detail(land).east	马滩水电站进水河	String	否	东至
param.detail(land).south	农田灌溉水渠	String	否	南至
param.detail(land).west	袁河车田段	String	否	西至
param.detail(land).north	车田村道	String	否	北至
param.detail(land).shape_desc	-	Object	否	不规则形状描述
param.detail(land).purpose	用途	String	否	土地用途
param.detail(land).location	宁夏回族自治区 固原市	String	否	坐落位置
param.detail(land).attachment	地上附着物	String	否	地上附着物说明
param.detail(land).desc	描述	String	否	其他说明
param.detail(building)	{}	Object	否	房屋建筑
param.detail(building).id	8399	Number	否	房屋建筑主键 id
param.detail(building).subjectCode	S252559	String	否	标的编码
param.detail(building).classify	商铺	String	否	类型
param.detail(building).location	河南省 许昌市	String	否	坐落位置
param.detail(building).buildTime	2013-11-12	String	否	构建时间
param.detail(building).buildingArea	90	Number	否	建筑面积
param.detail(building).registerBuildingArea	90	Number	否	产证注册面积
param.detail(building).areaUnit	平方米	String	否	面积单位
param.detail(building).purpose	用途	String	否	用途
param.detail(building).originalValue	15	Number	否	原值
param.detail(building).depreciatedValue	4	Number	否	已提折旧
param.detail(building).residualValue	11	Number	否	预计净残值
param.detail(building).valueUnit	万元	String	否	价值单位
param.detail(building).chargePerson	袁涛	String	否	负责人
param.detail(building).desc	描述	String	否	其他描述说明
param.detail(facility)	{}	Object	否	设施
param.detail(facility).id	2105	Integer	是	设施主键 id
param.detail(facility).subjectCode	S650748	String	否	标的编码
param.detail(facility).classify	水泵	String	否	设施类型
param.detail(facility).buildTime	2013-11-12	String	否	构建时间
param.detail(facility).quantity	4	Integer	否	数量
param.detail(facility).quantityUnit	台	String	否	计量单位
param.detail(facility).location	四川省 阿坝藏族羌族自治州	String	否	坐落位置
param.detail(facility).desc	描述	String	否	其他说明
param.detail(equipment)	{}	Object	否	设备
param.detail(equipment).id	3885	Number	否	设备主键 id
param.detail(equipment).subjectCode	S115075	String	否	标的编码
param.detail(equipment).classify	农用机械	String	否	设备类型
param.detail(equipment).location	四川省 阿坝藏族羌族自治州	String	否	坐落位置
param.detail(equipment).specification	规格型号	String	否	规格型号
param.detail(equipment).manufacturer	生产厂家	String	否	生产厂家
param.detail(equipment).purchaseTime	1999-04-08	String	否	购建时间
param.detail(equipment).quantity	2	Number	否	数量
param.detail(equipment).quantityUnit	台	String	否	计量单位
param.detail(equipment).originalValue	8	Number	否	原值
param.detail(equipment).depreciatedValue	3	Number	否	已提折旧
param.detail(equipment).residualValue	5	Number	否	预计净残值
param.detail(equipment).valueUnit	万元	String	否	价值单位
param.detail(equipment).chargePerson	孔静	String	否	责任人
param.detail(equipment).desc	描述	String	否	其他描述说明
param.detail(forest)	{}	Object	否	林权
param.detail(forest).id	2095	Number	否	林权主键 id
param.detail(forest).subjectCode	S487855	String	否	标的编码
param.detail(forest).location	位置	String	否	坐落位置
param.detail(forest).acreage	280	Number	否	面积
param.detail(forest).acreageUnit	亩	String	否	面积单位
param.detail(forest).shapeRule	Y	String	否	是否规则
param.detail(forest).east	农田	String	否	东至
param.detail(forest).south	山脊	String	否	南至
param.detail(forest).west	农田	String	否	西至
param.detail(forest).north	山脊	String	否	北至
param.detail(forest).shapeDesc	形状描述	String	否	不规则形状描述说明
param.detail(forest).purpose	用途	String	否	用途
param.detail(forest).classify	031	String	否	林地类型
param.detail(forest).forestRightsCode	2022-001	String	否	林权证编号
param.detail(forest).fellLicenseCode	34032202190201002	String	否	林木采伐许可证编号
param.detail(forest).treeType	杉木	String	否	主要树种
param.detail(forest).treeOrigin	天然林	String	否	林木起源
param.detail(forest).treeAmount	280	Integer	否	林木数量
param.detail(forest).amountUnit	棵	String	否	计量单位
param.detail(forest).averageTreeHeight	9	Number	否	平均树高
param.detail(forest).heightUnit	米	String	否	树高单位
param.detail(forest).averageTreeDiameter	12	Number	否	平均胸径
param.detail(forest).diameterUnit	厘米	String	否	胸径单位
param.detail(forest).treeAccumulation	360	Number	否	蓄积
param.detail(forest).accumulationUnit	方	String	否	蓄积单位
param.detail(forest).treeVolume	300	Number	否	材积
param.detail(forest).volumeUnit	方	String	否	材积单位
param.detail(forest).desc	描述	String	否	其他描述说明
param.attachments	[]	Object	否	标的附件
param.attachments.subjectCode	S424348	String	否	标的编码
param.attachments.attachmentClassify	subject_show	String	否	附件类型
param.attachments.name	标的展示图 1	String	否	附件名
param.attachments.path	/file/subject_show/3241234351235.jpg	String	否	附件路径

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200, //响应成功状态码
  "msg": "修改标的成功!", //返回文字描述
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "data": {
    "id": 9953 //标的主键id
  } //返回数据
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功代码
msg	修改标的成功!	String	响应消息
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据对象
data.id	9953	Integer	标的主键 id

• 失败响应示例

{
  "code": 500,
  "msg": "修改标的失败!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {}
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	修改标的失败!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据

删除标的

基本信息

接口状态：未开始
接口 URI: /api/subject/:uuid/:id/:code
请求方式：DELETE
Content-Type: application/json

请求参数

• 路径参数及说明

参数名	示例值	参数类型	是否必填	参数描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	是	请求 uuid
id	9953	Integer	是	标的主键 id
code	S424348	String	是	标的编码

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200, //响应成功状态码
  "msg": "删除标的成功!", //返回文字描述
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "data": {
    "id": 9953 //标的主键id
  } //返回数据
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功代码
msg	删除标的成功!	String	响应消息
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据对象
data.id	9953	Integer	标的主键 id

• 失败响应示例

{
  "code": 500,
  "msg": "删除标的失败!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {}
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	删除标的失败!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据

立项管理

查询项目列表

基本信息

接口状态：未开始
接口 URI: /api/s_project?uuid=2Ba7C78d-77Ff-e25b-183B-eF8795509bdd&page=1&limit=10&code=KG_CQ_2022_S_0001&name=空港新城 50.00 亩耕地
请求方式：GET
Content-Type: application/json

请求参数

• Query 参数及说明

参数名	示例值	参数类型	是否必填	参数描述
uuid	2Ba7C78d-77Ff-e25b-183B-eF8795509bdd	String	是	请求 uuid
page	1	Integer	是	页码
limit	10	Integer	是	每页数据量
code	KG_CQ_2022_S_0001	String	否	项目编号
name	空港新城 50.00 亩耕地	String	否	项目名称

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200, //响应成功状态码
  "msg": "查询成功!", //返回文字描述
  "uuid": "2Ba7C78d-77Ff-e25b-183B-eF8795509bdd", //请求uuid
  "data": {
    "total": 7, //项目总数
    "projects": [
      {
        "id": 14799, //项目主键id
        "code": "TDCBJYQ_S_61_2022_0005", //项目编号
        "name": "陕西省西咸新区空港新城50.00亩耕地", //项目名称
        "classify": "TDCBJYQ", //项目类型
        "status": "created", //项目状态
        "is_discussable": "N", //价格是否面议
        "listedPrice": 920.12, //挂牌价格
        "listedPriceUnit": "元/亩/年", //价格单位
        "publishedTime": "2022-04-12 14:29:59", //发布时间
        "tradeCenterCode": "TC-210231", //交易中心编码
        "tradeCenterName": "樟树市交易中心", //交易中心名称
        "tradeClassify": "free_bid", //交易方式
        "transferClassify": "rent_out", //转出方式
        "isRecommended": "Y" //是否推荐
      },
      {
        "id": 138997, //项目主键id
        "code": "JTJSYD_S_61_2022_0010", //项目编号
        "name": "乐陵市胡家街道韩家村村南中20亩土地", //项目名称
        "classify": "JTJSYD", //项目类型
        "status": "auditing", //项目状态
        "is_discussable": "N", //价格是否面议
        "listedPrice": 550, //挂牌价格
        "listedPriceUnit": "元/亩/年", //价格单位
        "publishedTime": "2022-04-12 14:29:59", //发布时间
        "tradeCenterCode": "TC-210412", //交易中心编码
        "tradeCenterName": "乐陵市交易中心", //交易中心名称
        "tradeClassify": "free_bid", //交易方式
        "transferClassify": "rent_out", //转出方式
        "isRecommended": "Y" //是否推荐
      },
      {
        "id": 954516, //项目主键id
        "code": "SHD_S_21_2022_0014", //项目编号
        "name": "沈阳市市胡家街道韩家村村南中45亩荒山", //项目名称
        "classify": "SHD", //项目类型
        "status": "published", //项目状态
        "is_discussable": "N", //价格是否面议
        "listedPrice": 320, //挂牌价格
        "listedPriceUnit": "元/亩/年", //价格单位
        "publishedTime": "2022-04-12 14:29:59", //发布时间
        "tradeCenterCode": "TC-215555", //交易中心编码
        "tradeCenterName": "沈阳市交易中心", //交易中心名称
        "tradeClassify": "free_bid", //交易方式
        "transferClassify": "rent_out", //转出方式
        "isRecommended": "Y" //是否推荐
      },
      {
        "id": 306891, //项目主键id
        "code": "JTJYXZC_S_2102_2022_1002", //项目编号
        "name": "天津武清精武镇韩家居委会89平米商铺", //项目名称
        "classify": "JTJYXZC", //项目类型
        "status": "created", //项目状态
        "is_discussable": "N", //价格是否面议
        "listedPrice": 2100, //挂牌价格
        "listedPriceUnit": "元/年", //价格单位
        "publishedTime": "2022-04-12 14:29:59", //发布时间
        "tradeCenterCode": "TC-125235", //交易中心编码
        "tradeCenterName": "天津市交易中心", //交易中心名称
        "tradeClassify": "stair_bid", //交易方式
        "transferClassify": "rent_out", //转出方式
        "isRecommended": "Y" //是否推荐
      },
      {
        "id": 219036, //项目主键id
        "code": "XXSLSS_S_2102_2022_1002", //项目编号
        "name": "天津西青杨村浑河9台水泵", //项目名称
        "classify": "XXSLSS", //项目类型
        "status": "created", //项目状态
        "is_discussable": "N", //价格是否面议
        "listedPrice": 1100, //挂牌价格
        "listedPriceUnit": "元/年", //价格单位
        "publishedTime": "2022-04-12 14:29:59", //发布时间
        "tradeCenterCode": "TC-125235", //交易中心编码
        "tradeCenterName": "天津市交易中心", //交易中心名称
        "tradeClassify": "stair_bid", //交易方式
        "transferClassify": "rent_out", //转出方式
        "isRecommended": "N" //是否推荐
      },
      {
        "id": 395724, //项目主键id
        "code": "XXSLSS_S_2102_2022_1002", //项目编号
        "name": "天津西青杨村浑河水坝灌溉设施", //项目名称
        "classify": "XXSLSS", //项目类型
        "status": "created", //项目状态
        "is_discussable": "Y", //价格是否面议
        "publishedTime": "2022-04-12 14:29:59", //发布时间
        "tradeCenterCode": "TC-125235", //交易中心编码
        "tradeCenterName": "天津市交易中心", //交易中心名称
        "tradeClassify": "stair_bid", //交易方式
        "transferClassify": "rent_out", //转出方式
        "isRecommended": "N" //是否推荐
      },
      {
        "id": 544940, //项目主键id
        "code": "LQ_S_2102_2022_1002", //项目编号
        "name": "沣西新城马王街道办事处马王村1000亩林地使用权", //项目名称
        "classify": "LQ", //项目类型
        "status": "created", //项目状态
        "is_discussable": "Y", //价格是否面议
        "listedPrice": 1100, //挂牌价格
        "listedPriceUnit": "元/亩/年", //价格单位
        "publishedTime": "2022-04-12 14:29:59", //发布时间
        "tradeCenterCode": "TC-125235", //交易中心编码
        "tradeCenterName": "西咸市交易中心", //交易中心名称
        "tradeClassify": "free_bid", //交易方式
        "transferClassify": "rent_out", //转出方式
        "isRecommended": "Y" //是否推荐
      }
    ] //项目数组
  } //返回数据
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功代码
msg	查询成功!	String	响应消息
uuid	2Ba7C78d-77Ff-e25b-183B-eF8795509bdd	String	请求 uuid
data	{}	Object	返回数据
data.total	7	Integer	项目总数
data.projects	[]	Array	项目数组
data.projects.id	14799	Integer	项目主键 id
data.projects.code	TDCBJYQ_S_61_2022_0005	String	项目编号
data.projects.name	陕西省西咸新区空港新城 50.00 亩耕地	String	项目名称
data.projects.classify	TDCBJYQ	String	项目类型
data.projects.status	created	String	项目状态
data.projects.is_discussable	N	String	价格是否面议
data.projects.listedPrice	920.12	Number	挂牌价格
data.projects.listedPriceUnit	元/亩/年	String	价格单位
data.projects.publishedTime	2022-04-12 14:29:59	String	发布时间
data.projects.tradeCenterCode	TC-210231	String	交易中心编码
data.projects.tradeCenterName	樟树市交易中心	String	交易中心名称
data.projects.tradeClassify	free_bid	String	交易方式
data.projects.transferClassify	rent_out	String	转出方式
data.projects.isRecommended	Y	String	是否推荐

• 失败响应示例

{
  "code": 500,
  "msg": "查询失败!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {}
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	查询失败!	String	响应消息
uuid	2Ba7C78d-77Ff-e25b-183B-eF8795509bdd	String	请求 uuid
data	{}	Object	返回数据对象

新增供应项目

基本信息

接口状态：未开始
接口 URI: /api/s_project
请求方式：POST
Content-Type: application/json

请求参数

• Body 参数及说明

{
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "param": {
    "code": "TDCBJYQ_S_61_2022_0005", //项目编号
    "name": "陕西省西咸新区空港新城50.00亩耕地", //项目名称
    "classify": "TDCBJYQ", //项目类型
    "status": "created", //项目状态
    "is_discussable": "N", //价格是否面议
    "listedPrice": 920.12, //挂牌价格
    "listedPriceUnit": "元/亩/年", //价格单位
    "publishedTime": "2022-04-12 14:29:59", //发布时间
    "tradeCenterCode": "TC-210231", //交易中心编码
    "tradeCenterName": "樟树市交易中心", //交易中心名称
    "tradeClassify": "free_bid", //交易方式
    "transferClassify": "rent_out", //转出方式
    "isRecommended": "Y", //是否推荐
    "projectVendor": {
      "projectCode": "TDCBJYQ_S_61_2022_0005", //项目编号
      "projectName": "陕西省西咸新区空港新城50.00亩耕地", //项目名称
      "vendorCode": "V76366194", //供方编码
      "vendorFullName": "陕西省西咸新区空港新城村集体" //供方名称
    }, //项目供方关联
    "projectSubject": {
      "projectCode": "TDCBJYQ_S_61_2022_0005", //项目编号
      "projectName": "陕西省西咸新区空港新城50.00亩耕地", //项目名称
      "vendorCode": "V76366194", //供方编码
      "vendorFullName": "陕西省西咸新区空港新城村集体", //供方全称
      "projectClassify": "TDCBJYQ", //项目类型
      "subjectCode": "S424348", //标的编码
      "subjectName": "空港新城50.00亩耕地", //标的名称
      "subjectClassify": "land" //标的类型
    }, //项目标的关联
    "transfer": {
      "projectCode": "TDCBJYQ_S_61_2022_0005", //项目编号
      "subjectCode": "S424348", //标的编码
      "rentStartTime": "1987-03-06 16:43:29", //租赁开始时间
      "rentEndTime": "2022-04-12 15:40:37", //租赁结束时间
      "rentTerm": 30, //租赁期限
      "rentTermUnit": "年", //期限单位
      "rentCollectMethod": "前两年一付，后三年一付，再后五年一付。每五年上调5%。", //租金收取方式
      "rentCondition": "", //承租条件
      "desc": "" //其他说明
    }, //转出方式对象
    "trade": {
      "projectCode": "TDCBJYQ_S_61_2022_0005", //项目编号
      "applyStartTime": "1990-09-21 02:13:50", //报名开始时间
      "applyEndTime": "2022-04-12 15:40:37", //报名结束时间
      "bidStartTime": "1995-02-07 11:48:18", //竞价开始时间
      "bidEndTime": "2022-04-12 15:40:37" //竞价结束时间
    }, //交易方式对象
    "attachments": [
      {
        "projectCode": "TDCBJYQ_S_61_2022_0005", //项目编号
        "attachmentClassify": "s_project", //附件类型
        "name": "项目图片001", //标的名称
        "path": "/file/s_project/3241234351235.jpg" //附件路径
      },
      {
        "projectCode": "TDCBJYQ_S_61_2022_0005", //项目编号
        "attachmentClassify": "s_project", //附件类型
        "name": "项目图片002", //标的名称
        "path": "/file/s_project/3241234351235.jpg" //附件路径
      }
    ] //标的附件数组
  } //请求参数
}

• 字段描述

参数名	示例值	参数类型	是否必填	参数描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	是	请求 uuid
param	{}	Object	是	请求参数
param.code	TDCBJYQ_S_61_2022_0005	String	是	项目编号
param.name	陕西省西咸新区空港新城 50.00 亩耕地	String	是	项目名称
param.classify	TDCBJYQ	String	是	项目类型
param.status	created	String	是	项目状态
param.is_discussable	N	String	是	价格是否面议
param.listedPrice	920.12	Number	否	挂牌价格
param.listedPriceUnit	元/亩/年	String	否	价格单位
param.publishedTime	2022-04-12 14:29:59	String	否	发布时间
param.tradeCenterCode	TC-210231	String	是	交易中心编码
param.tradeCenterName	樟树市交易中心	String	是	交易中心名称
param.tradeClassify	free_bid	String	是	交易方式
param.transferClassify	rent_out	String	是	转出方式
param.isRecommended	Y	String	否	是否推荐
param.projectVendor	{}	Object	是	项目供方关联
param.projectVendor.projectCode	TDCBJYQ_S_61_2022_0005	String	是	项目编号
param.projectVendor.projectName	陕西省西咸新区空港新城 50.00 亩耕地	String	是	项目名称
param.projectVendor.vendorCode	V76366194	String	是	供方编码
param.projectVendor.vendorFullName	陕西省西咸新区空港新城村集体	String	是	供方名称
param.projectSubject	{}	Object	是	项目标的关联
param.projectSubject.projectCode	TDCBJYQ_S_61_2022_0005	String	是	项目编号
param.projectSubject.projectName	陕西省西咸新区空港新城 50.00 亩耕地	String	是	项目名称
param.projectSubject.vendorCode	V76366194	String	是	供方编码
param.projectSubject.vendorFullName	陕西省西咸新区空港新城村集体	String	是	供方全称
param.projectSubject.projectClassify	TDCBJYQ	String	是	项目类型
param.projectSubject.subjectCode	S424348	String	是	标的编码
param.projectSubject.subjectName	空港新城 50.00 亩耕地	String	是	标的名称
param.projectSubject.subjectClassify	land	String	是	标的类型
param.transfer	{}	Object	是	转出方式对象
param.transfer.projectCode	TDCBJYQ_S_61_2022_0005	String	是	项目编号
param.transfer.subjectCode	S424348	String	是	标的编码
param.transfer.rentStartTime	1987-03-06 16:43:29	String	是	租赁开始时间
param.transfer.rentEndTime	2022-04-12 15:40:37	String	是	租赁结束时间
param.transfer.rentTerm	30	Number	是	租赁期限
param.transfer.rentTermUnit	年	String	是	期限单位
param.transfer.rentCollectMethod	前两年一付，后三年一付，再后五年一付。每五年上调 5%。	String	否	租金收取方式
param.transfer.rentCondition	-	String	否	承租条件
param.transfer.desc	-	String	否	其他说明
param.trade	{}	Object	是	交易方式对象
param.trade.projectCode	TDCBJYQ_S_61_2022_0005	String	是	项目编号
param.trade.applyStartTime	1990-09-21 02:13:50	String	是	报名开始时间
param.trade.applyEndTime	2022-04-12 15:40:37	String	是	报名结束时间
param.trade.bidStartTime	1995-02-07 11:48:18	String	是	竞价开始时间
param.trade.bidEndTime	2022-04-12 15:40:37	String	是	竞价结束时间
param.attachments	[]	Object	否	标的附件数组
param.attachments.projectCode	TDCBJYQ_S_61_2022_0005	String	否	项目编号
param.attachments.attachmentClassify	s_project	String	否	附件类型
param.attachments.name	项目图片 001	String	否	标的名称
param.attachments.path	/file/s_project/3241234351235.jpg	String	否	附件路径

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200, //响应成功状态码
  "msg": "添加项目成功!", //返回文字描述
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "data": {
    "id": 3592 //项目主键id
  } //返回数据
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功状态码
msg	添加项目成功!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	-	Object	返回数据
data.id	3592	Integer	项目主键 id

• 失败响应示例

{
  "code": 500, //响应失败状态码
  "msg": "添加项目失败!", //返回文字描述
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "data": {} //返回数据
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	添加项目失败!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据

修改供应项目

基本信息

接口状态：未开始
接口 URI: api/s_project
请求方式：PUT
Content-Type: application/json

请求参数

• Body 参数及说明

{
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "param": {
    "id": 3592, //供应主键id
    "code": "TDCBJYQ_S_61_2022_0005", //项目编号
    "name": "陕西省西咸新区空港新城50.00亩耕地", //项目名称
    "classify": "TDCBJYQ", //项目类型
    "status": "created", //项目状态
    "is_discussable": "N", //价格是否面议
    "listedPrice": 920.12, //挂牌价格
    "listedPriceUnit": "元/亩/年", //价格单位
    "publishedTime": "2022-04-12 14:29:59", //发布时间
    "tradeCenterCode": "TC-210231", //交易中心编码
    "tradeCenterName": "樟树市交易中心", //交易中心名称
    "tradeClassify": "free_bid", //交易方式
    "transferClassify": "rent_out", //转出方式
    "isRecommended": "Y", //是否推荐
    "projectVendor": {
      "id": 622, //项目供方关联主键id
      "projectCode": "TDCBJYQ_S_61_2022_0005", //项目编号
      "projectName": "陕西省西咸新区空港新城50.00亩耕地", //项目名称
      "vendorCode": "V76366194", //供方编码
      "vendorFullName": "陕西省西咸新区空港新城村集体" //供方名称
    }, //项目供方关联
    "projectSubject": {
      "id": 721, //项目标的关联主键id
      "projectCode": "TDCBJYQ_S_61_2022_0005", //项目编号
      "projectName": "陕西省西咸新区空港新城50.00亩耕地", //项目名称
      "vendorCode": "V76366194", //供方编码
      "vendorFullName": "陕西省西咸新区空港新城村集体", //供方名称
      "projectClassify": "TDCBJYQ", //项目类型
      "subjectCode": "S424348", //标的编码
      "subjectName": "空港新城50.00亩耕地", //标的名称
      "subjectClassify": "land" //标的类型
    }, //项目标的关联
    "transfer": {
      "id": 872, //转出方式主键id
      "projectCode": "TDCBJYQ_S_61_2022_0005", //项目编号
      "subjectCode": "S424348", //标的编码
      "rentStartTime": "1987-03-06 16:43:29", //租赁开始时间
      "rentEndTime": "2022-04-12 15:40:37", //租赁结束时间
      "rentTerm": 30, //租赁期限
      "rentTermUnit": "年", //期限单位
      "rentCollectMethod": "前两年一付，后三年一付，再后五年一付。每五年上调5%。", //租金收取方式
      "rentCondition": "", //承租条件
      "desc": "" //其他说明
    }, //转出方式对象
    "trade": {
      "id": 7992, //交易方式主键id
      "projectCode": "TDCBJYQ_S_61_2022_0005", //项目编号
      "applyStartTime": "1990-09-21 02:13:50", //报名开始时间
      "applyEndTime": "2022-04-12 15:40:37", //报名结束时间
      "bidStartTime": "1995-02-07 11:48:18", //竞价开始时间
      "bidEndTime": "2022-04-12 15:40:37" //竞价结束时间
    }, //交易方式对象
    "attachments": [
      {
        "projectCode": "TDCBJYQ_S_61_2022_0005", //项目编号
        "attachmentClassify": "s_project", //附件类型
        "name": "项目图片001", //标的名称
        "path": "/file/s_project/3241234351235.jpg" //附件路径
      },
      {
        "projectCode": "TDCBJYQ_S_61_2022_0005", //项目编号
        "attachmentClassify": "s_project", //附件类型
        "name": "项目图片002", //标的名称
        "path": "/file/s_project/3241234351235.jpg" //附件路径
      }
    ] //标的附件
  } //请求参数
}

• 字段描述

参数名	示例值	参数类型	是否必填	参数描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	是	请求 uuid
param	{}	Object	是	请求参数
param.id	3592	Integer	是	供应主键 id
param.code	TDCBJYQ_S_61_2022_0005	String	是	项目编号
param.name	陕西省西咸新区空港新城 50.00 亩耕地	String	否	项目名称
param.classify	TDCBJYQ	String	否	项目类型
param.status	created	String	否	项目状态
param.is_discussable	N	String	否	价格是否面议
param.listedPrice	920.12	Number	否	挂牌价格
param.listedPriceUnit	元/亩/年	String	否	价格单位
param.publishedTime	2022-04-12 14:29:59	String	否	发布时间
param.tradeCenterCode	TC-210231	String	否	交易中心编码
param.tradeCenterName	樟树市交易中心	String	否	交易中心名称
param.tradeClassify	free_bid	String	否	交易方式
param.transferClassify	rent_out	String	否	转出方式
param.isRecommended	Y	String	否	是否推荐
param.projectVendor	{}	Object	否	项目供方关联
param.projectVendor.id	622	Number	否	项目供方关联主键 id
param.projectVendor.projectCode	TDCBJYQ_S_61_2022_0005	String	否	项目编号
param.projectVendor.projectName	陕西省西咸新区空港新城 50.00 亩耕地	String	否	项目名称
param.projectVendor.vendorCode	V76366194	String	否	供方编码
param.projectVendor.vendorFullName	陕西省西咸新区空港新城村集体	String	否	供方名称
param.projectSubject	{}	Object	否	项目标的关联
param.projectSubject.id	721	Number	否	项目标的关联主键 id
param.projectSubject.projectCode	TDCBJYQ_S_61_2022_0005	String	否	项目编号
param.projectSubject.projectName	陕西省西咸新区空港新城 50.00 亩耕地	String	否	项目名称
param.projectSubject.vendorCode	V76366194	String	否	供方编码
param.projectSubject.vendorFullName	陕西省西咸新区空港新城村集体	String	否	供方名称
param.projectSubject.projectClassify	TDCBJYQ	String	否	项目类型
param.projectSubject.subjectCode	S424348	String	否	标的编码
param.projectSubject.subjectName	空港新城 50.00 亩耕地	String	否	标的名称
param.projectSubject.subjectClassify	land	String	否	标的类型
param.transfer	{}	Object	否	转出方式对象
param.transfer.id	872	Integer	否	转出方式主键 id
param.transfer.projectCode	TDCBJYQ_S_61_2022_0005	String	否	项目编号
param.transfer.subjectCode	S424348	String	否	标的编码
param.transfer.rentStartTime	1987-03-06 16:43:29	String	否	租赁开始时间
param.transfer.rentEndTime	2022-04-12 15:40:37	String	否	租赁结束时间
param.transfer.rentTerm	30	Integer	否	租赁期限
param.transfer.rentTermUnit	年	String	否	期限单位
param.transfer.rentCollectMethod	前两年一付，后三年一付，再后五年一付。每五年上调 5%。	String	否	租金收取方式
param.transfer.rentCondition	-	String	否	承租条件
param.transfer.desc	-	String	否	其他说明
param.trade	{}	Object	否	交易方式对象
param.trade.id	7992	Integer	否	交易方式主键 id
param.trade.projectCode	TDCBJYQ_S_61_2022_0005	String	否	项目编号
param.trade.applyStartTime	1990-09-21 02:13:50	String	否	报名开始时间
param.trade.applyEndTime	2022-04-12 15:40:37	String	否	报名结束时间
param.trade.bidStartTime	1995-02-07 11:48:18	String	否	竞价开始时间
param.trade.bidEndTime	2022-04-12 15:40:37	String	否	竞价结束时间
param.attachments	[]	Object	否	标的附件
param.attachments.projectCode	TDCBJYQ_S_61_2022_0005	String	否	项目编号
param.attachments.attachmentClassify	s_project	String	否	附件类型
param.attachments.name	项目图片 001	String	否	标的名称
param.attachments.path	/file/s_project/3241234351235.jpg	String	否	附件路径

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200, //响应成功状态码
  "msg": "修改供方成功!", //返回文字描述
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "data": {
    "id": 3592 //项目主键id
  } //返回数据
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功状态码
msg	修改项目成功!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据
data.id	3592	Integer	项目主键 id

• 失败响应示例

{
  "code": 500, //响应状态码
  "msg": "修改供方失败!", //返回文字描述
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "data": {} //返回数据
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	修改项目失败!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据

删除供应项目

基本信息

接口状态：未开始
接口 URI: /api/s_project/:uuid/:id/:code
请求方式：DELETE
Content-Type: application/json

请求参数

• 路径参数及说明

参数名	示例值	参数类型	是否必填	参数描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	是	请求 uuid
id	14799	Integer	是	项目主键 id
code	TDCBJYQ_S_61_2022_0005	String	是	项目编号

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200,
  "msg": "删除项目成功!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {
    "id": 14799
  }
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功代码
msg	删除项目成功!	String	响应消息
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据对象
data.id	14799	Integer	项目主键 id

• 失败响应示例

{
  "code": 500,
  "msg": "删除项目失败!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {}
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	删除项目失败!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据

挂牌公告

查询挂牌公告列表

基本信息

接口状态：未开始
接口 URI: /api/s_project/list_affiche?uuid=2Ba7C78d-77Ff-e25b-183B-eF8795509bdd&page=1&limit=10&code=KG_CQ_2022_S_0001&title=空港新城 50.00 亩耕地
请求方式：GET
Content-Type: application/json

请求参数

• Query 参数及说明

参数名	示例值	参数类型	是否必填	参数描述
uuid	2Ba7C78d-77Ff-e25b-183B-eF8795509bdd	String	是	请求 uuid
page	1	Integer	是	页码
limit	10	Integer	是	每页数据量
code	KG_CQ_2022_S_0001	String	否	公告编号
title	空港新城 50.00 亩耕地	String	否	公告标题

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200, //响应成功状态码
  "msg": "查询成功!", //返回文字描述
  "uuid": "2Ba7C78d-77Ff-e25b-183B-eF8795509bdd", //请求uuid
  "data": {
    "total": 7, //挂牌公告总数
    "listAffiches": [
      {
        "id": 14799, //挂牌公告主键id
        "code": "挂牌公告编号", //挂牌公告编号
        "title": "挂牌公告标题", //挂牌公告标题
        "projectCode": "TDCBJYQ_S_61_2022_0005", //项目编号
        "projectName": "陕西省西咸新区空港新城50.00亩耕地", //项目名称
        "projectClassify": "TDCBJYQ", //项目类型
        "status": "created", //公告状态
        "is_discussable": "N", //价格是否面议
        "listPrice": 920.12, //挂牌价格
        "listPriceUnit": "元/亩/年", //价格单位
        "listStartDate": "2022-04-01", //挂牌开始日期
        "listEndDate": "2022-04-12", //挂牌结束日期
        "listTerm": 13, //挂牌期限
        "listTermUnit": "天", //期限单位
        "isRecommended": "Y", //是否推荐
        "tradeCenterCode": "TC-210412", //交易中心编码
        "tradeCenterName": "乐陵市交易中心", //交易中心名称
        "tradeClassify": "free_bid", //交易方式
        "transferClassify": "rent_out", //转出方式
        "reportCode": "公告模板代码" //公告模板代码
      },
      {
        "id": 138997, //挂牌公告主键id
        "code": "挂牌公告编号", //挂牌公告编号
        "title": "挂牌公告标题", //挂牌公告标题
        "projectCode": "JTJSYD_S_61_2022_0010", //项目编号
        "projectName": "乐陵市胡家街道韩家村村南中20亩土地", //项目名称
        "projectClassify": "JTJSYD", //项目类型
        "status": "auditing", //公告状态
        "is_discussable": "N", //价格是否面议
        "listPrice": 550, //挂牌价格
        "listPriceUnit": "元/亩/年", //价格单位
        "listStartDate": "2022-04-01", //挂牌开始日期
        "listEndDate": "2022-04-12", //挂牌结束日期
        "listTerm": 13, //挂牌期限
        "listTermUnit": "天", //期限单位
        "isRecommended": "Y", //是否推荐
        "tradeCenterCode": "TC-210412", //交易中心编码
        "tradeCenterName": "乐陵市交易中心", //交易中心名称
        "tradeClassify": "free_bid", //交易方式
        "transferClassify": "rent_out", //转出方式
        "reportCode": "公告模板代码" //公告模板代码
      },
      {
        "id": 954516, //挂牌公告主键id
        "code": "挂牌公告编号", //挂牌公告编号
        "title": "挂牌公告标题", //挂牌公告标题
        "projectCode": "SHD_S_21_2022_0014", //项目编号
        "projectName": "沈阳市市胡家街道韩家村村南中45亩荒山", //项目名称
        "projectClassify": "SHD", //项目类型
        "status": "published", //公告状态
        "is_discussable": "N", //价格是否面议
        "listedPrice": 320,
        "listedPriceUnit": "元/亩/年",
        "listStartDate": "2022-04-01", //挂牌开始日期
        "listEndDate": "2022-04-12", //挂牌结束日期
        "listTerm": 13, //挂牌期限
        "listTermUnit": "天", //期限单位
        "isRecommended": "Y", //是否推荐
        "tradeCenterCode": "TC-215555", //交易中心编码
        "tradeCenterName": "沈阳市交易中心", //交易中心名称
        "tradeClassify": "free_bid", //交易方式
        "transferClassify": "rent_out", //转出方式
        "reportCode": "公告模板代码" //公告模板代码
      },
      {
        "id": 306891, //挂牌公告主键id
        "code": "挂牌公告编号", //挂牌公告编号
        "title": "挂牌公告标题", //挂牌公告标题
        "projectCode": "JTJYXZC_S_2102_2022_1002", //项目编号
        "projectName": "天津武清精武镇韩家居委会89平米商铺", //项目名称
        "projectClassify": "JTJYXZC", //项目类型
        "status": "created", //公告状态
        "is_discussable": "N", //价格是否面议
        "listPrice": 2100, //挂牌价格
        "listPriceUnit": "元/年", //价格单位
        "listStartDate": "2022-04-01", //挂牌开始日期
        "listEndDate": "2022-04-12", //挂牌结束日期
        "listTerm": 13, //挂牌期限
        "listTermUnit": "天", //期限单位
        "isRecommended": "Y", //是否推荐
        "tradeCenterCode": "TC-125235", //交易中心编码
        "tradeCenterName": "天津市交易中心", //交易中心名称
        "tradeClassify": "stair_bid", //交易方式
        "transferClassify": "rent_out", //转出方式
        "reportCode": "公告模板代码" //公告模板代码
      },
      {
        "id": 219036, //挂牌公告主键id
        "code": "挂牌公告编号", //挂牌公告编号
        "title": "挂牌公告标题", //挂牌公告标题
        "projectCode": "XXSLSS_S_2102_2022_1002", //项目编号
        "projectName": "天津西青杨村浑河9台水泵", //项目名称
        "projectClassify": "XXSLSS", //项目类型
        "status": "created", //公告状态
        "is_discussable": "N", //价格是否面议
        "listPrice": 1100, //挂牌价格
        "listPriceUnit": "元/年", //价格单位
        "listStartDate": "2022-04-01", //挂牌开始日期
        "listEndDate": "2022-04-12", //挂牌结束日期
        "listTerm": 13, //挂牌期限
        "listTermUnit": "天", //期限单位
        "isRecommended": "N", //是否推荐
        "tradeCenterCode": "TC-125235", //交易中心编码
        "tradeCenterName": "天津市交易中心", //交易中心名称
        "tradeClassify": "stair_bid", //交易方式
        "transferClassify": "rent_out", //转出方式
        "reportCode": "公告模板代码" //公告模板代码
      },
      {
        "id": 395724, //挂牌公告主键id
        "code": "挂牌公告编号", //挂牌公告编号
        "title": "挂牌公告标题", //挂牌公告标题
        "projectCode": "XXSLSS_S_2102_2022_1002", //项目编号
        "projectName": "天津西青杨村浑河水坝灌溉设施", //项目名称
        "projectClassify": "XXSLSS", //项目类型
        "status": "created", //公告状态
        "is_discussable": "Y", //价格是否面议
        "listStartDate": "2022-04-01", //挂牌开始日期
        "listEndDate": "2022-04-12", //挂牌结束日期
        "listTerm": 13, //挂牌期限
        "listTermUnit": "天", //期限单位
        "isRecommended": "N", //是否推荐
        "tradeCenterCode": "TC-125235", //交易中心编码
        "tradeCenterName": "天津市交易中心", //交易中心名称
        "tradeClassify": "stair_bid", //交易方式
        "transferClassify": "rent_out", //转出方式
        "reportCode": "公告模板代码" //公告模板代码
      },
      {
        "id": 544940, //挂牌公告主键id
        "code": "挂牌公告编号", //挂牌公告编号
        "title": "挂牌公告标题", //挂牌公告标题
        "projectCode": "LQ_S_2102_2022_1002", //项目编号
        "projectName": "沣西新城马王街道办事处马王村1000亩林地使用权", //项目名称
        "projectClassify": "LQ", //项目类型
        "status": "created", //公告状态
        "is_discussable": "Y", //价格是否面议
        "listedPrice": 1100,
        "listedPriceUnit": "元/亩/年",
        "listStartDate": "2022-04-01", //挂牌开始日期
        "listEndDate": "2022-04-12", //挂牌结束日期
        "listTerm": 13, //挂牌期限
        "listTermUnit": "天", //期限单位
        "isRecommended": "Y", //是否推荐
        "tradeCenterCode": "TC-125235", //交易中心编码
        "tradeCenterName": "西咸市交易中心", //交易中心名称
        "tradeClassify": "free_bid", //交易方式
        "transferClassify": "rent_out", //转出方式
        "reportCode": "公告模板代码" //公告模板代码
      }
    ] //挂牌公告数组
  } //返回数据
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功代码
msg	查询成功!	String	响应消息
uuid	2Ba7C78d-77Ff-e25b-183B-eF8795509bdd	String	请求 uuid
data	{}	Object	返回数据
data.total	7	Integer	项目总数
data.listAffiches	[]	Array	挂牌公告数组
data.listAffiches.id	14799	Number	挂牌公告主键 id
data.listAffiches.code	挂牌公告编号	String	挂牌公告编号
data.listAffiches.title	挂牌公告标题	String	挂牌公告标题
data.listAffiches.projectCode	TDCBJYQ_S_61_2022_0005	String	项目编号
data.listAffiches.projectName	陕西省西咸新区空港新城 50.00 亩耕地	String	项目名称
data.listAffiches.projectClassify	TDCBJYQ	String	项目类型
data.listAffiches.status	created	String	公告状态
data.listAffiches.is_discussable	N	String	价格是否面议
data.listAffiches.listPrice	920.12	Number	挂牌价格
data.listAffiches.listPriceUnit	元/亩/年	String	价格单位
data.listAffiches.listStartDate	2022-04-01	String	挂牌开始日期
data.listAffiches.listEndDate	2022-04-12	String	挂牌结束日期
data.listAffiches.listTerm	13	Integer	挂牌期限
data.listAffiches.listTermUnit	天	String	期限单位
data.listAffiches.isRecommended	Y	String	是否推荐
data.listAffiches.tradeCenterCode	TC-210412	String	交易中心编码
data.listAffiches.tradeCenterName	乐陵市交易中心	String	交易中心名称
data.listAffiches.tradeClassify	free_bid	String	交易方式
data.listAffiches.transferClassify	rent_out	String	转出方式
data.listAffiches.reportCode	公告模板代码	String	公告模板代码

• 失败响应示例

{
  "code": 500,
  "msg": "查询失败!",
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1",
  "data": {}
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	查询失败!	String	响应消息
uuid	2Ba7C78d-77Ff-e25b-183B-eF8795509bdd	String	请求 uuid
data	{}	Object	返回数据对象

修改挂牌公告

基本信息

接口状态：未开始
接口 URI: /api/s_project/list_affiche
请求方式：PUT
Content-Type: application/json

请求参数

• Body 参数及说明

{
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "param": {
    "id": 14799, //标的主键id
    "code": "挂牌公告编号", //公告编号
    "title": "挂牌公告名称", //公告标题
    "projectCode": "TDCBJYQ_S_61_2022_0005", //项目编号
    "projectName": "陕西省西咸新区空港新城50.00亩耕地", //项目名称
    "projectClassify": "TDCBJYQ", //项目类型
    "status": "created", //公告状态
    "is_discussable": "N", //价格是否面议
    "listPrice": 920.12, //挂牌价格
    "listPriceUnit": "元/亩/年", //价格单位
    "listStartDate": "2022-04-01", //挂牌开始日期
    "listEndDate": "2022-04-12", //挂牌结束日期
    "listTerm": 13, //挂牌期限
    "listTermUnit": "天", //期限单位
    "isRecommended": "Y", //是否推荐
    "tradeCenterCode": "TC-210412", //交易中心编码
    "tradeCenterName": "乐陵市交易中心", //交易中心名称
    "tradeClassify": "free_bid", //交易方式
    "transferClassify": "rent_out", //转出方式
    "reportCode": "公告模板代码" //公告模板代码
  } //请求参数
}

• 字段描述

参数名	示例值	参数类型	是否必填	参数描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	是	请求 uuid
param	{}	Object	是	请求参数
param.id	14799	Integer	是	公告主键 id
param.code	挂牌公告编号	String	否	公告编号
param.title	挂牌公告名称	String	否	公告标题
param.projectCode	TDCBJYQ_S_61_2022_0005	String	否	项目编号
param.projectName	陕西省西咸新区空港新城 50.00 亩耕地	String	否	项目名称
param.projectClassify	TDCBJYQ	String	否	项目类型
param.status	created	String	否	公告状态
param.is_discussable	N	String	否	价格是否面议
param.listPrice	920.12	Number	否	挂牌价格
param.listPriceUnit	元/亩/年	String	否	价格单位
param.listStartDate	2022-04-01	String	否	挂牌开始日期
param.listEndDate	2022-04-12	String	否	挂牌结束日期
param.listTerm	13	Number	否	挂牌期限
param.listTermUnit	天	String	否	期限单位
param.isRecommended	Y	String	否	是否推荐
param.tradeCenterCode	TC-210412	String	否	交易中心编码
param.tradeCenterName	乐陵市交易中心	String	否	交易中心名称
param.tradeClassify	free_bid	String	否	交易方式
param.transferClassify	rent_out	String	否	转出方式
param.reportCode	公告模板代码	String	否	公告模板代码

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200, //响应成功状态码
  "msg": "修改挂牌公告成功!", //返回文字描述
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "data": {
    "id": 14799 //挂牌公告主键id
  } //返回数据
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功状态码
msg	修改挂牌公告成功!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据
data.id	14799	Integer	挂牌公告主键 id

• 失败响应示例

{
  "code": 500, //响应状态码
  "msg": "修改挂牌公告失败!", //返回文字描述
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "data": {} //返回数据
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	修改挂牌公告失败!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据

预览挂牌公告

基本信息

接口状态：未开始
接口 URI: /api/s_project/:uuid/:id/:code
请求方式：GET
Content-Type: application/json

请求参数

• 路径参数及说明

参数名	示例值	参数类型	是否必填	参数描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	是	请求 uuid
code	TDCBJYQ_S_61_2022_0005	String	是	公告编号

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

发布挂牌公告

基本信息

接口状态：未开始
接口 URI: /api/s_project/list_affiche/publish
请求方式：PUT
Content-Type: application/json

请求参数

• Body 参数及说明

{
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "param": {
    "id": 14799 //挂牌公告主键id
  } //请求参数
}

• 字段描述

参数名	示例值	参数类型	是否必填	参数描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	是	请求 uuid
param	{}	Object	是	请求参数
param.id	14799	Integer	是	公告主键 id

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200, //响应成功状态码
  "msg": "发布挂牌公告成功!", //返回文字描述
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "data": {
    "id": 14799 //挂牌公告主键id
  } //返回数据
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功状态码
msg	发布挂牌公告成功!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据
data.id	14799	Integer	挂牌公告主键 id

• 失败响应示例

{
  "code": 500, //响应状态码
  "msg": "发布挂牌公告失败!", //返回文字描述
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "data": {} //返回数据
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	发布挂牌公告失败!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据

项目摘牌

基本信息

接口状态：未开始
接口 URI: /api/s_project/list_affiche/recall
请求方式：PUT
Content-Type: application/json

请求参数

• Body 参数及说明

{
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "param": {
    "id": 14799 //挂牌公告主键id
  } //请求参数
}

• 字段描述

参数名	示例值	参数类型	是否必填	参数描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	是	请求 uuid
param	{}	Object	是	请求参数
param.id	14799	Integer	是	公告主键 id

• 认证及说明

认证类型：Bearer auth 认证
Authorization：Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTY0OTg5OTU4MywiaWF0Ijox NjQ5Mjk0NzgzLCJqdGkiOiJkOTRkZjA1NWFjYmU0MjcyOTY4MTgzNDZlMGI3ZTFkOSJ9.NtoSzzebwntHV2W9fsk NJmFKZPp8LKS7cmVpJsPDLhbnurh5VaE03T021bJGIVvcS6s_qo8S16T0J2zxnjX0_g

响应示例

• 成功响应示例

{
  "code": 200, //响应成功状态码
  "msg": "摘牌成功!", //返回文字描述
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "data": {
    "id": 14799 //挂牌公告主键id
  } //返回数据
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	200	Integer	响应成功状态码
msg	摘牌成功!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据
data.id	14799	Integer	挂牌公告主键 id

• 失败响应示例

{
  "code": 500, //响应状态码
  "msg": "摘牌失败!", //返回文字描述
  "uuid": "1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1", //请求uuid
  "data": {} //返回数据
}

• 字段描述

参数名	示例值	参数类型	参数描述
code	500	Integer	响应失败代码
msg	摘牌失败!	String	返回文字描述
uuid	1e5C02b1-bE37-Df1B-d92B-f299bc95C6e1	String	请求 uuid
data	{}	Object	返回数据